NextJS项目启动报错EINVAL errno:-4071，求解决方案

问题详情 #

使用npm run dev启动NextJS项目时触发以下错误：

[Error: EINVAL: invalid argument, readlink 'C:\Users\cxXni\OneDrive\Documents\AA-DEV\ctsolutions\frontend\.next\server\vendor-chunks\framer-motion.js'] {
  errno: -4071,
  code: 'EINVAL',
  syscall: 'readlink',
  path: 'C:\\Users\\cxXni\\OneDrive\\Documents\\AA-DEV\\ctsolutions\\frontend\\.next\\server\\vendor-chunks\\framer-motion.js'
}

已尝试的无效操作：

• 重启电脑
• 删除node_modules并执行npm i
• 移除近期新增的依赖包
• 删除最后添加的组件

环境信息：

• Node版本：v20.12.2
• npm版本：v10.5.2
• 依赖清单：

"dependencies": {
    "@radix-ui/react-dropdown-menu": "^2.0.6",
    "@radix-ui/react-icons": "^1.3.0",
    "@radix-ui/react-navigation-menu": "^1.1.4",
    "@radix-ui/react-select": "^2.0.0",
    "@radix-ui/react-slot": "^1.0.2",
    "class-variance-authority": "^0.7.0",
    "clsx": "^2.1.0",
    "framer-motion": "^11.1.7",
    "i18next": "^23.11.2",
    "i18next-resources-to-backend": "^1.2.1",
    "next": "^14.2.2",
    "next-i18n-router": "^5.4.0",
    "next-themes": "^0.3.0",
    "react": "^18",
    "react-dom": "^18",
    "react-i18next": "^14.1.0",
    "tailwind-merge": "^2.2.2",
    "tailwindcss-animate": "^1.0.7"
  },
  "devDependencies": {
    "@types/node": "^20",
    "@types/react": "^18",
    "@types/react-dom": "^18",
    "eslint": "^8",
    "eslint-config-next": "14.2.1",
    "postcss": "^8",
    "prettier": "^3.2.5",
    "prettier-plugin-tailwindcss": "^0.5.14",
    "tailwindcss": "^3.4.1",
    "typescript": "^5"
  }

解决方案 #

从错误路径看，项目存储在OneDrive目录下，这类错误大概率是OneDrive的同步机制破坏了NextJS构建缓存中的符号链接导致的，按以下步骤尝试：

• 彻底清理构建缓存
  删除.next目录（这是NextJS的构建缓存目录，里面的损坏符号链接是问题根源）：
  Windows命令：

rmdir /s /q .next

然后重新执行npm run dev。

• 将项目移出OneDrive目录
  OneDrive的实时同步、按需同步功能经常会干扰Node项目的文件操作（尤其是符号链接、临时缓存文件）。把整个项目文件夹复制到本地非同步路径（比如C:\Projects\ctsolutions-frontend），然后重新运行npm install和npm run dev。

• 重新安装framer-motion
  单独卸载并重新安装framer-motion，确保依赖包的文件完整性：

npm uninstall framer-motion
npm install framer-motion@11.1.7

• 禁用OneDrive按需同步（若必须保留在OneDrive）
  打开OneDrive设置 → 选择“设置”选项卡 → 找到“文件按需同步” → 选择“仅同步此PC上的文件”，确保所有项目文件都本地存储，避免OneDrive将文件转为在线占位符导致readlink操作失败。

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