Nodejs writeFile 间歇性出现 EPERM 问题，如何 debug

发布于 1周前 作者 sinazl 来自 nodejs/Nestjs

Nodejs writeFile 间歇性出现 EPERM 问题，如何 debug

这个问题困扰我们很久了， 在基于 electron 的客户端，使用 writeFile 来创建图片文件在用户本地， 但是偶尔会报错误： { “errno”: -4048, “code”: “EPERM”, “syscall”: “open”, “path”: “C:\Users\abc\Documents\xxxx\xxxxxx\derived50833397\IMG_20211220_045044_630.jpg” }

这个错误只出现在 windows 系统里，mac 系统没有报告。 发生在多个用户上，间歇性的。但是一旦发生，同样的错误就会连续产生。

已经排除了杀毒软件的干扰。 在写之前检查写入目录 C:\Users\abc\Documents\xxxx\xxxxxx\derived50833397 权限是 o666 。而且在这个文件之前有别的文件（非 image 文件）写入成功。 应该是有 race condition 存在，但不知道该怎么 debug 。 有没有大神指教可以考虑哪些原因？


Harmonyos Next教程
6 回复

VSCode 也出现过这种情况，安装卸载扩展的时候冒出一大堆 EPERM ，不清楚什么原因


先检查是否对文件拥有权限，再检查文件是否设置为了只读。
建议报错时捕捉到错误之后，对文件的权限相关信息进行一个日志上的输出，拥有足够的信息后再 debug 。

（如果可以稳定复现的话，可以考虑用 SysInternals 里的 Procmon 工具看系统 api 失败的详细原因（

换个编程语言写个 exe ，调子进程来写

打开 nodejs fs api 全局搜索 EPERM

https://man7.org/linux/man-pages/man2/mkdir.2.html
EPERM 包含路径名的文件系统不支持目录的创建。
EPERM The filesystem containing pathname does not support the creation of directories.

On Windows, opening an existing hidden file using the ‘w’ flag (either through fs.open() or fs.writeFile() or fsPromises.open()) will fail with EPERM. Existing hidden files can be opened for writing with the ‘r+’ flag.

在 Windows 上，使用“w”标志（通过 fs.open （）或 fs ）打开现有的隐藏文件。writeFile （）或 fsPromises 。open （））将使用 EPERM 失败。可以使用“r+”标志打开现有隐藏文件进行写入。

可能是存在同名的隐藏文件

fs.writeFile(file, data[, options], callback)
options 参数对象上 flag 默认值： ‘w’。尝试改成 “r+”

再不行就可能是 nodejs 的 bug 了

遇到 Node.js 的 writeFile 间歇性出现 EPERM（Error PERMission）问题时，通常表明文件或目录的权限不足，或者文件正在被其他进程使用。以下是一些调试步骤和代码示例，帮助你定位和解决问题：

  1. 检查文件权限： 确保运行 Node.js 脚本的用户有权限写入目标文件。你可以使用 ls -l（Linux/macOS）或 dir（Windows）命令查看文件权限。

  2. 检查文件是否在使用： 如果文件被其他进程锁定，可能会导致 EPERM 错误。可以尝试捕捉异常并延迟重试。

    const fs = require('fs');
const filePath = 'path/to/your/file.txt';
const data = 'Your data here';

function writeFileWithRetry(path, content, retries = 3, delay = 1000) {
    fs.writeFile(path, content, (err) => {
        if (err && err.code === 'EPERM' && retries > 0) {
            setTimeout(() => writeFileWithRetry(path, content, retries - 1, delay), delay);
        } else {
            if (err) console.error('Write failed:', err);
            else console.log('Write successful');
        }
    });
}

writeFileWithRetry(filePath, data);

  3. 检查文件系统状态： 确保文件系统没有损坏，并且磁盘空间充足。

  4. 运行脚本的用户： 确认你以正确的用户身份运行脚本，特别是当在服务器或受限环境中时。

通过以上步骤，你应该能够定位并解决 writeFile 出现的 EPERM 问题。如果问题依旧存在，可能需要更深入地检查系统日志或咨询系统管理员。

回到顶部