Node.js的qrcode模块是生成二维码的常用工具，它的大部分API都是异步设计的，很多开发者在初次使用时容易忽略异步特性，导致无法正确拿到生成的二维码数据。下面先介绍qrcode模块的基础使用逻辑，再逐一讲解不同异步场景下的正确获取方式。
qrcode模块的异步特性说明
qrcode模块提供的核心生成方法，比如toDataURL、toString等，默认都是异步执行的，不会立即返回结果。如果直接像同步代码一样调用并赋值，得到的结果会是undefined或者Promise对象，无法拿到实际的二维码数据。
常见错误用法示例
很多开发者会写出下面这样的错误代码：
const qrcode = require('qrcode');
// 错误示例：直接赋值获取结果
const qrData = qrcode.toDataURL('https://ipipp.com');
console.log(qrData); // 输出Promise对象，不是实际的二维码数据
正确获取二维码数据的三种方式
1. 使用回调函数获取
qrcode的异步方法都支持传入回调函数作为最后一个参数，回调函数的第一个参数是错误对象，第二个参数是生成的二维码数据。
const qrcode = require('qrcode');
// 回调函数方式获取二维码数据
qrcode.toDataURL('https://ipipp.com', (err, data) => {
if (err) {
console.error('生成二维码失败:', err);
return;
}
console.log('生成的二维码数据:', data); // 这里可以拿到正确的base64格式的二维码数据
});
2. 使用Promise方式获取
如果不传入回调函数，qrcode的异步方法会返回一个Promise对象，我们可以通过then和catch来处理结果。
const qrcode = require('qrcode');
// Promise方式获取二维码数据
qrcode.toDataURL('https://ipipp.com')
.then(data => {
console.log('生成的二维码数据:', data);
})
.catch(err => {
console.error('生成二维码失败:', err);
});
3. 使用async/await方式获取
在async函数中，我们可以使用await关键字等待qrcode的异步方法执行完成，这是目前最简洁的写法，需要注意要用try...catch捕获错误。
const qrcode = require('qrcode');
// async/await方式获取二维码数据
async function generateQrCode() {
try {
const data = await qrcode.toDataURL('https://ipipp.com');
console.log('生成的二维码数据:', data);
return data;
} catch (err) {
console.error('生成二维码失败:', err);
}
}
generateQrCode();
不同生成方法的数据获取差异
qrcode模块提供了多个生成方法，不同方法返回的二维码数据格式不同，需要根据需求选择：
| 方法名 | 返回数据格式 | 适用场景 |
|---|---|---|
| toDataURL | base64格式的图片字符串 | 前端直接展示、接口返回 |
| toString | 二维码的字符矩阵字符串 | 需要自定义渲染二维码的场景 |
| toFile | 无返回值，直接写入文件 | 生成二维码图片文件保存到服务器 |
注意事项
- 使用toFile方法时，因为是写入文件，不需要获取返回数据，只需要监听回调或者Promise的状态判断生成是否成功即可。
- 不要在异步方法外部直接访问二维码数据，因为异步操作可能还没执行完成，拿到的会是初始值或者undefined。
- 生成二维码的内容如果是动态拼接的，需要确保内容已经正确获取之后再调用qrcode的生成方法，避免内容为空导致生成失败。
异步操作的核心是要等待操作完成之后再处理结果，qrcode模块的异步设计是为了避免阻塞Node.js的事件循环，保证服务的并发处理能力，理解这一点就能避免大部分数据获取的问题。