使用 async/await 处理文件读写错误的核心是用 try/catch 捕获 promise 拒绝,需使用 fs.promises api(node.js 10+),避免混用回调;所有 await 必须包裹在 try 中,根据 err.code 差异化处理,写入前确保目录存在,并全局监听 unhandledrejection 作为兜底。

使用 async/await 处理文件读写错误,核心是用 try/catch 捕获 Promise 拒绝(reject),而不是依赖回调里的 error 参数。Node.js 的 fs.promises API 天然返回 Promise,配合 async/await 可让错误处理更直观、更接近同步代码逻辑。
确保使用 Promise 版本的 fs API
Node.js 10+ 提供了 fs.promises 模块,它是 fs 的 Promise 封装。不要混用老式回调写法(如 fs.readFile(..., callback)),否则 await 无法生效,错误也无法被 catch 捕获。
- ✅ 正确:
const data = await fs.promises.readFile('file.txt', 'utf8'); - ❌ 错误:
await fs.readFile('file.txt', callback);(callback 不返回 Promise,await 无意义)
用 try/catch 包裹异步操作
所有可能失败的 await 行都应放在 try 块中,catch 捕获具体错误。常见错误包括 ENOENT(文件不存在)、EACCES(权限不足)、EINVAL(编码错误)等。
- 捕获后可判断
err.code做差异化处理,比如对 ENOENT 提示“文件未找到”,对 EACCES 提示“无访问权限” - 不要只写
catch (err) { console.error(err); },应明确处理逻辑或重新抛出 - 示例:
try {<br> const content = await fs.promises.readFile('config.json', 'utf8');<br> return JSON.parse(content);<br>} catch (err) {<br> if (err.code === 'ENOENT') {<br> throw new Error('配置文件不存在,请检查路径');<br> } else if (err.code === 'EJSONPARSE') {<br> throw new Error('配置文件格式错误');<br> } else {<br> throw err; // 其他错误原样抛出<br> }<br>}
写入文件时注意覆盖与目录存在性
fs.promises.writeFile 默认会覆盖文件,但若目标目录不存在(比如 logs/app.log 中 logs 文件夹未创建),会报 ENOTDIR 或 ENOENT。需提前确保路径存在。
- 可用
fs.promises.mkdir(path.dirname(filepath), { recursive: true })创建多层目录 - 建议将读/写封装成函数,并统一处理路径和错误,避免重复逻辑
- 例如写入前先建目录:
await fs.promises.mkdir(path.dirname('./data/user.json'), { recursive: true });<br>await fs.promises.writeFile('./data/user.json', JSON.stringify(user));
避免未捕获的 Promise 拒绝
如果某个 await 调用没被 try/catch 包裹,且对应 Promise 被拒绝,就会触发 unhandledRejection 事件,可能导致进程崩溃或静默失败。
- 在应用顶层(如入口文件)监听一次:
process.on('unhandledRejection', console.error);作为兜底 - 但根本解法是:每个
async函数内部,对所有可能出错的await显式处理 - 尤其注意链式调用中多个
await,每一处都可能失败,不要假设前一步成功就省略 try/catch











