Windows环境下Next.js执行npm run build时出现EPERM权限错误

错误信息 #

Creating an optimized production build...

[uncaughtException] [Error: EPERM: operation not permitted, open 'D:\Folder\gamer-survey.next\trace']

你已尝试的操作：

• 以管理员身份运行VS Code/终端
• 删除.next文件夹后重新构建
• 确保无其他进程锁定该文件夹

以下是补充的排查和解决步骤：

• 检查安全软件拦截：Windows Defender或第三方杀毒软件可能会阻止Next.js写入.trace文件。临时关闭实时保护功能，重新执行构建；如果成功，将项目根目录和.next文件夹添加到安全软件的信任列表。
• 调整文件夹权限：右键点击项目根目录D:\Folder\gamer-survey → 属性 → 安全选项卡 → 编辑 → 选中你的用户账户，勾选“完全控制”权限，应用后重新构建。
• 切换Node.js版本：部分Node.js版本可能存在Windows文件系统兼容性问题，使用nvm切换到LTS版本（如18.x或20.x），删除node_modules和package-lock.json后重新执行npm install，再尝试构建。
• 禁用Windows快速启动：快速启动可能导致文件资源锁定，依次打开控制面板→电源选项→选择电源按钮的功能→更改当前不可用的设置→取消勾选“启用快速启动”，重启电脑后再执行构建。
• 直接用管理员终端执行命令：避开VS Code终端的权限继承问题，直接打开管理员命令提示符，cd到项目目录后执行npm run build。
• 清理npm缓存并重装依赖：执行npm cache clean --force，删除node_modules和package-lock.json，重新运行npm install，再尝试构建。

内容的提问来源于stack exchange，提问作者Adil Parwez