Nuxt电商应用部署Heroku报code=H10错误 配置端口后仍崩溃如何解决

1. 补全nuxt.config.js的server配置 #

你仅配置了端口读取环境变量，未绑定host字段读取之前配置的HOST环境变量，Heroku要求应用必须监听0.0.0.0才能对外提供服务，修改server配置如下：

server: {
    port: process.env.PORT || 4002,
    host: process.env.HOST || '0.0.0.0' // 新增该字段
},

2. 适配SPA模式部署规则 #

你配置了ssr: false纯SPA模式，两种可选优化方案：

• 方案一（保留Node伺服）：确认所有运行时必需依赖都放在package.json的dependencies字段下，不要放在devDependencies。Heroku生产部署默认不会安装开发依赖，缺失依赖会导致服务启动后直接退出。如果不想移动依赖，可执行命令关闭生产依赖限制：

  heroku config:set NPM_CONFIG_PRODUCTION=false
  

• 方案二（改用静态站点部署，同时解决slug超体积问题）：SPA模式无需Node运行时伺服，静态部署体积更小、启动更快：
  1. 安装静态buildpack：

  heroku buildpacks:add https://github.com/heroku/heroku-buildpack-static.git
  

  2. 修改package.json的heroku-postbuild命令为npm run generate
  3. 项目根目录新增static.json配置文件：

  {
    "root": "dist",
    "clean_urls": true,
    "routes": {
      "/**": "index.html"
    }
  }
  

3. 确认Node版本兼容 #

在package.json中添加engines字段，指定和本地开发环境一致的Node.js大版本，避免Heroku默认版本兼容问题：

"engines": {
  "node": "16.x" // 替换为你本地实际使用的Node版本，如14.x、18.x均可
}

4. 本地验证启动逻辑 #

部署前先本地模拟生产环境启动，排查本地可复现的问题：

npm run build
NODE_ENV=production npm run start

如果本地启动正常，再通过Heroku命令查看完整启动日志定位问题：

heroku logs --tail --ps web

重点排查模块缺失、配置语法错误、端口绑定失败类提示。

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