NextJS部署求助：构建步骤未在45分钟内完成报错

问题场景 #

本地localhost可正常运行的NextJS应用，部署时触发报错：

"Your deployment's build step did not complete within the maximum of 45min"

排查与解决方向 #

1. 优化依赖安装效率 #

• 清理package.json中无用依赖，移除体积大、安装耗时的冗余包（如未使用的全量UI库）
• 改用更高效的包管理器：推荐用pnpm替代npm/yarn，它的依赖安装速度更快且占用空间更少
• 安装时跳过安全审计节省时间：执行pnpm install --no-audit或npm install --no-audit
• 开启部署平台的依赖缓存功能（多数托管平台如Vercel、Netlify默认支持，需确认配置是否开启）

2. 减少构建时资源处理耗时 #

• 优化静态资源：压缩图片（转WebP格式）、移除未使用的大体积资源；在next.config.js中通过images.remotePatterns限制图片来源，避免不必要的资源处理
• 优化代码导入：将非首屏必需的组件改为动态导入，比如：

  import dynamic from 'next/dynamic'
  const HeavyComponent = dynamic(() => import('../components/HeavyComponent'), { ssr: false })
  

• 简化Webpack配置：尽量使用NextJS默认配置，避免添加不必要的loader或插件，若自定义配置需检查是否存在性能瓶颈

3. 排查代码逻辑导致的构建阻塞 #

• 检查getStaticProps、getServerSideProps、generateStaticParams等数据获取逻辑：是否存在无限循环、外部接口请求超时/卡住的情况？本地环境数据量小或网络稳定可能不会触发，部署时需确保接口响应正常、数据处理逻辑无阻塞
• 本地模拟生产构建：执行next build观察耗时，若本地构建也慢，用next build --debug查看详细日志，定位到具体卡住的页面或步骤

4. 提升部署环境资源 #

• 若为自建服务器部署：升级服务器CPU、内存，NextJS大型项目构建需要足够的计算资源
• 若为托管平台部署：查看是否有升级构建实例的选项（如Vercel Pro计划提供更大的构建资源）

验证步骤 #

1. 本地执行next build确认是否能正常完成，记录耗时，先解决本地构建的性能问题
2. 查看部署平台的构建日志，定位到具体卡住的阶段，针对性优化

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