Next.js关联Prismic项目执行npm run dev报错，页面无法加载求助

我正在开发关联Prismic的Next.js网站，此前运行正常，但电脑休眠后再次执行npm run dev时，页面无法加载，出现以下错误：

> npm run dev

> creative-portfolio-a@0.1.0 dev
> next dev

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

Error: EINVAL: invalid argument, readlink 'C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\.next\app-build-manifest.json'    
    at async Object.readlink (node:internal/fs/promises:963:10)
    at async C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\lib\recursive-delete.js:58:30
    at async Promise.all (index 0)
    at async recursiveDelete (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\lib\recursive-delete.js:51:5)
    at async Span.traceAsyncFn (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\trace\trace.js:151:20)    
    at async HotReloaderWebpack.start (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\server\dev\hot-reloader-webpack.js:588:9)
    at async startWatcher (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\server\lib\router-utils\setup-dev-bundler.js:1195:5)
    at async setupDevBundler (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\server\lib\router-utils\setup-dev-bundler.js:1809:20)
    at async Span.traceAsyncFn (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\trace\trace.js:151:20)    
    at async initialize (C:\Users\abdal\OneDrive\سطح المكتب\ReactNative\Creative Portfolio\creative-portfolio-a\node_modules\next\dist\server\lib\router-server.js:74:30) {
  errno: -4071,
  code: 'EINVAL',
  syscall: 'readlink',
  path: 'C:\\Users\\abdal\\OneDrive\\سطح المكتب\\ReactNative\\Creative Portfolio\\creative-portfolio-a\\.next\\app-build-manifest.json'
}

解决方案 #

• 删除项目根目录下的.next文件夹，重新执行npm run dev，让Next.js重新生成构建缓存文件。
• 执行npm cache clean --force清除npm缓存，避免依赖缓存引发的异常。
• 迁移项目路径：当前路径包含阿拉伯文和空格，Windows环境对这类路径支持可能存在问题，建议将项目移动到纯英文、无空格的路径中（例如C:\Projects\CreativePortfolio）。
• 彻底重启电脑，释放被占用的文件资源后再启动开发服务。

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