VS中运行Next.js项目遇生产构建缺失错误求助

问题描述 #

在VS中运行React+Next.js项目时，反复触发以下错误：

Error: Could not find a production build in the 'C:\Users\isaac\OneDrive\Desktop\iteck_react.next' directory. Try building your app with 'next build' before starting the production server.

完整报错堆栈：

Error: Could not find a production build in the 'C:\Users\isaac\OneDrive\Desktop\iteck_react\.next' directory. Try building your app with 'next build' before starting the production server.
    at NextNodeServer.getBuildId (C:\Users\OneDrive\Desktop\freact\node_modules\next\dist\server\next-server.js:169:23)
    at new Server (C:\Users\OneDrive\Desktop\freact\node_modules\next\dist\server\base-server.js:58:29)
    at new NextNodeServer (C:\Users\OneDrive\Desktop\freact\node_modules\next\dist\server\next-server.js:70:9)
    at NextServer.createServer (C:\Users\OneDrive\Desktop\freact\node_modules\next\dist\server\next.js:140:16)
    at async C:\Users\OneDrive\Desktop\freact\node_modules\next\dist\server\next.js:149:3

项目配置信息 #

package.json #

{
  "name": "iteck",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",    
    "export": "next build && next export",
    "lint": "next lint"
  },
  "dependencies": {
    "axios": "^0.27.2",
    "lightgallery": "^2.5.0",
    "next": "^12.0.7",
    "rc-slider": "^10.0.1",
    "react": "^17.0.2",
    "react-dom": "^17.0.2",
    "react-modal-video": "^1.2.9",
    "sass": "^1.54.3",
    "swiper": "^8.3.2"
  },
  "devDependencies": {
    "eslint": "8.21.0",
    "eslint-config-next": "12.2.3"
  }
}

next.config.js #

/** @type {import('next').NextConfig} */
const path = require("path");

const nextConfig = {
  reactStrictMode: false,
  sassOptions: {
    includePaths: [path.join(__dirname, "css")],
  },
  trailingSlash: true,
  devIndicators: {
    buildActivity: false,
  },
  eslint: {
    ignoreDuringBuilds: false,
  },
}

module.exports = nextConfig

已尝试的无效操作 #

• 重新安装node_modules
• 多次执行next build和next start命令
• 查阅网上常规解决方案无效

排查与解决步骤 #

• 确认命令执行目录：检查VS终端当前路径是否为项目根目录C:\Users\isaac\OneDrive\Desktop\iteck_react（报错中出现C:\Users\OneDrive\Desktop\freact，疑似目录混淆），执行cd C:\Users\isaac\OneDrive\Desktop\iteck_react切换后，再运行npm run build。
• 验证构建文件生成：执行npm run build后，查看项目根目录是否生成.next文件夹，且内部包含build-id、static等文件。如果未生成，查看build命令的输出日志，排查编译错误（如ESLint报错、依赖缺失、路径配置问题）。
• 规避OneDrive权限/同步问题：将项目复制到非OneDrive本地目录（如C:\Projects\iteck_react），重新执行npm install、npm run build、npm run start。
• 清理缓存后重建：
  Windows环境执行：

  rmdir /s /q .next node_modules
  del package-lock.json
  npm install
  npm run build
  npm run start
  

  类Unix环境执行：

  rm -rf .next node_modules package-lock.json
  npm install
  npm run build
  npm run start
  

• 修复版本兼容性：当前next版本12.0.7与eslint-config-next版本12.2.3不匹配，将两者版本统一（如都升级到12.2.3），重新安装依赖后构建。

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