Next.js 13.5.6无法生成build文件夹及GoDaddy cPanel部署求助

一、先排查npm run build无输出文件夹的问题 #

1. 确认Next.js输出目录 #

Next.js 13.5（尤其是App Router模式）默认构建输出是.next文件夹，而非传统的build。如果需要指定输出目录，可通过next.config.js配置：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'export', // 静态导出模式，会生成out文件夹
  // 若保留SSR模式，默认输出仍为.next
}

module.exports = nextConfig

如果一定要生成build文件夹，可修改package.json的build命令：

{
  "scripts": {
    "build": "next build && mv .next build"
  }
}

2. 排查构建失败原因 #

执行npm run build时紧盯终端报错信息，常见问题及修复：

• 依赖缺失：执行npm install重新安装所有依赖
• 代码错误：比如App Router下组件导出格式错误、路由命名不符合规范，根据终端提示定位修复
• Node.js版本不兼容：Next.js 13.5要求Node.js 16.8+，用node -v检查版本，不符合则升级

二、GoDaddy cPanel部署Next.js项目方案 #

方案1：静态导出部署（适合纯静态/静态生成页面） #

1. 在next.config.js中添加output: 'export'，执行npm run build生成out文件夹
2. 将out文件夹压缩为ZIP包
3. 登录GoDaddy cPanel，进入文件管理器，打开public_html目录
4. 上传ZIP包，解压到public_html根目录（或子目录，对应子域名部署）
5. 若部署到子目录，需在next.config.js中添加basePath: '/your-subdirectory'

方案2：服务器端渲染（SSR）部署（适合动态页面） #

GoDaddy cPanel支持Node.js应用，步骤如下：

1. 确保构建生成.next文件夹，将package.json、package-lock.json、.next打包为ZIP
2. 登录cPanel，找到Node.js应用工具，点击创建应用
3. 配置应用参数：
   • 选择Node.js版本（16.8+）
   • 设置应用根目录（例如/home/your-username/next-app）
   • 设置启动文件：node_modules/next/dist/bin/next start
   • 端口由cPanel自动分配，记录该端口
4. 上传ZIP包到应用根目录并解压
5. 在cPanel的终端中进入应用根目录，执行npm install --production安装生产依赖
6. 启动Node.js应用，在cPanel的域名工具中绑定域名
7. 配置.htaccess转发请求到Node.js端口，示例：

RewriteEngine On
RewriteRule ^(.*)$ http://localhost:YOUR_ASSIGNED_PORT/$1 [P,L]

注意事项 #

• GoDaddy cPanel的Node.js应用有资源限制，若项目较大可能需要升级主机套餐
• 静态导出模式不支持SSR、API路由等动态功能，需根据项目需求选择部署方案

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