Node.js中fs.readFile异步回调的UnhandledPromiseRejectionWarning处理

当你把异步函数作为fs.readFile的回调时，直接throw err会触发UnhandledPromiseRejectionWarning，原因是：普通回调里的throw会被Node.js的回调错误捕获机制处理，但异步函数执行后会返回一个Promise，fs.readFile本身不监听这个Promise的拒绝状态，所以抛出的错误会变成未处理的Promise拒绝。

下面是几种正确的错误处理方式：

1. 在异步回调内部用完整的try/catch包裹所有逻辑 #

把回调里的所有代码（包括错误判断和异步操作）都放进try块，用catch统一捕获所有错误：

const fs = require('fs');

fs.readFile('/file_does_not_exist.txt', 'utf8', async (err, data) => {
  try {
    if (err) throw err;
    // 这里写需要await的异步操作
    const processedData = await processData(data);
    console.log(processedData);
  } catch (error) {
    // 统一处理所有错误：包括fs.readFile的错误和后续异步操作的错误
    console.error('读取或处理文件出错:', error);
    // 也可以做日志记录、告警等其他处理
  }
});

注意：如果只把await部分放进try，而if(err) throw err在外面，那这部分抛出的错误还是会触发警告，必须把整个逻辑都包裹进去。

2. 改用Promise版本的fs.readFile（推荐） #

Node.js从10.x版本开始提供了fs.promises模块，或者用util.promisify转换回调式API，这样可以用更简洁的async/await + try/catch处理错误，避免回调嵌套：

方式一：使用fs.promises #

const fs = require('fs').promises;

async function readAndProcessFile() {
  try {
    const data = await fs.readFile('/file_does_not_exist.txt', 'utf8');
    // 执行异步处理逻辑
    const result = await processData(data);
    console.log(result);
  } catch (error) {
    console.error('操作失败:', error);
  }
}

readAndProcessFile();

方式二：用util.promisify转换 #

const fs = require('fs');
const { promisify } = require('util');

// 把回调式的readFile转换成Promise版本
const readFileAsync = promisify(fs.readFile);

async function readAndProcessFile() {
  try {
    const data = await readFileAsync('/file_does_not_exist.txt', 'utf8');
    const result = await processData(data);
    console.log(result);
  } catch (error) {
    console.error('操作失败:', error);
  }
}

readAndProcessFile();

3. 手动捕获异步回调返回的Promise拒绝 #

如果一定要保留回调形式，可以手动捕获异步函数返回的Promise的拒绝状态：

const fs = require('fs');

fs.readFile('/file_does_not_exist.txt', 'utf8', async (err, data) => {
  if (err) throw err;
  // await异步操作
  await processData(data);
}).catch(error => {
  console.error('处理错误:', error);
});

这里利用了异步函数返回Promise的特性，通过.catch()捕获所有抛出的错误。

内容的提问来源于stack exchange，提问作者Donald Zhu