执行yarn install后无报错信息却返回exit code 1的问题排查

1. 先获取完整的错误日志 #

当前返回的日志过于简略，无法定位核心问题，必须先拿到详细的构建输出：

• 修改package.json中的build命令为："build": "next build --debug"，再执行yarn build
• 或者直接运行命令：yarn build --verbose
  通过以上操作能看到构建过程中具体的报错环节，比如依赖安装异常、代码编译错误、静态生成逻辑失败等关键信息。

2. 强制锁定依赖版本 #

生产环境中依赖版本变动是常见故障诱因，用lock文件强制安装固定版本：
执行命令：yarn install --frozen-lockfile
该命令会严格遵循yarn.lock中的依赖版本进行安装，避免因package.json中的版本范围（如^/~）拉取到不兼容的新版本依赖。

3. 检查Node.js版本兼容性 #

Next.js不同版本对Node.js有明确的版本要求：

• 执行node -v查看当前Node版本
• 对照项目package.json中next的版本，确认版本匹配：
  • Next.js 13+ 要求 Node.js 16.8及以上
  • Next.js 12 要求 Node.js 14.6及以上
    若版本不匹配，使用nvm/n等工具切换到对应版本后重新尝试构建。

4. 排查代码与构建阶段问题 #

• 先执行yarn dev启动开发服务器，确认项目能正常运行，排除代码语法错误、依赖导入错误等基础问题
• 若dev模式正常但build失败，重点排查：
  • 静态生成（getStaticProps/getStaticPaths）或服务端渲染（getServerSideProps）中的异步逻辑错误
  • 生产环境缺失必要的环境变量（检查.env.production文件配置是否完整）
  • 组件中使用了仅开发环境可用的API（如process.env.NODE_ENV判断逻辑错误）

5. 清理Next.js构建缓存 #

有时.next文件夹的缓存会引发异常：
执行命令：rm -rf .next，之后重新执行yarn build

6. 检查Next.js配置文件 #

排查next.config.js中的配置是否存在兼容性问题：

• 自定义webpack配置是否与当前Next.js版本冲突
• 图片域名、重定向规则等配置是否正确

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