Node.js文件操作Promise报错：data参数类型错误排查求助

错误原因 #

• 参数未传递引发类型错误
  你执行writeFileAsync()时没传入path和data两个必填参数，导致这两个参数值为undefined。而fs.writeFile要求data必须是字符串、Buffer等有效类型，因此触发TypeError [ERR_INVALID_ARG_TYPE]。同时Promise被reject后，你没有处理这个拒绝状态，所以出现UnhandledPromiseRejectionWarning。

• resolve后代码无法执行
  在Promise回调里，resolve()调用后会立即敲定Promise的状态，后续的console.log代码永远不会执行，这些日志无法输出。

• 错误信息不够具体
  你reject时只返回固定文本，没有传递实际的错误对象，无法定位具体问题原因。

修复后的代码 #

注意：首先确保你已经引入了fs模块，否则会出现fs is not defined的错误。

const fs = require('fs');

const writeFileAsync = async (path, data) => {
    return new Promise((resolve, reject) => {
        fs.writeFile(path, data, (err) => {
            if (err) {
                return reject(new Error(`创建文件失败：${err.message}`));
            }
            console.log('文件已创建');
            resolve();
        });
    });
};

const appendFileAsync = async (path, data) => {
    return new Promise((resolve, reject) => {
        fs.appendFile(path, data, (err) => {
            if (err) {
                return reject(new Error(`追加内容失败：${err.message}`));
            }
            console.log('内容追加成功');
            resolve();
        });
    });
};

正确调用示例 #

必须传入path和data参数，并且通过.catch()或try/catch处理可能的错误：

方式1：使用.then().catch()链式调用 #

writeFileAsync('./demo.txt', '初始内容')
    .then(() => appendFileAsync('./demo.txt', '\n新增的追加内容'))
    .catch(err => console.error('操作出错：', err.message));

方式2：使用async/await配合try/catch #

async function executeFileOps() {
    try {
        await writeFileAsync('./demo.txt', '初始内容');
        await appendFileAsync('./demo.txt', '\n新增的追加内容');
    } catch (err) {
        console.error('操作出错：', err.message);
    }
}

executeFileOps();

内容的提问来源于stack exchange，提问作者Danila Maslov