Next.js项目运行npm run dev时出现EINVAL错误求助

问题情况 #

• 项目此前运行正常，突然执行npm run dev触发错误
• 已尝试清理Next.js缓存、重新安装node_modules，问题未解决
• 完整错误输出：

$ npm run dev

constructnet@0.1.0 dev
next dev

▲ Next.js 14.1.4
- Local:        http://localhost:3000

[Error: EINVAL: invalid argument, readlink 'C:\Users\sharon sajan\OneDrive - Don Bosco Institute of Technology\Desktop\ConstructNet-Next.js\constructnet.next\static\webpack\5cb4901185ad33c4.webpack.hot-update.json']
{   errno: -4071,   code: 'EINVAL',   syscall: 'readlink',   path: 'C:\Users\sharon sajan\OneDrive - Don Bosco Institute of Technology\Desktop\ConstructNet-Next.js\constructnet\.next\static\webpack\5cb4901185ad33c4.webpack.hot-update.json' }

排查与解决建议 #

• 检查OneDrive同步状态：项目目录在OneDrive下，同步异常可能导致文件链接失效。暂停OneDrive同步后重启项目，或者直接把项目移到非OneDrive目录测试。
• 彻底清理构建缓存：手动删除项目根目录下的.next文件夹，再重新执行npm run dev。
• 修复文件夹权限：右键项目文件夹→属性→安全，确认当前用户拥有该文件夹的完全控制权限。
• 临时禁用热更新：在next.config.js中添加以下配置关闭热更新，验证是否是热更新文件引发的问题：

module.exports = {
  webpack: (config) => {
    config.watchOptions = {
      ignored: /node_modules/,
      poll: false,
    };
    return config;
  },
};

• 升级Node.js版本：当前Node.js版本可能和Next.js 14.1.4存在兼容问题，升级到LTS版本（如20.x）后，重新安装依赖并启动项目。

内容的提问来源于stack exchange，提问作者Sharon Sajan