You need to enable JavaScript to run this app. Node.js Fastify API部署至Heroku出现H10应用崩溃错误求助
优惠活动
大模型
产品
解决方案
定价
更多

Node.js Fastify API部署至Heroku出现H10应用崩溃错误求助

云托管环境下Fastify应用H10报错排查

报错本质

H10是云托管平台上的进程崩溃标记,触发原因是应用未完成外部可访问的端口监听,平台健康检查校验失败,最终返回503应用错误。

具体问题与修正方案

  • Fastify 监听地址配置错误
    Fastify 默认仅监听本地回环地址127.0.0.1,在云平台动态分配端口的环境下,这个地址无法接收平台转发的外部请求,健康检查会直接判定应用不可达,触发崩溃。当前代码的listen调用仅传入了端口参数,没有指定公开监听的host。
    原监听代码:
    fastify.listen(process.env.PORT, (err, address) => {
        if (err) throw err
        fastify.log.info(`server listening on ${address}`)
    })
    
    修正后需要补充公开监听地址,同时加本地环境的端口兜底、错误退出逻辑:
    fastify.listen(process.env.PORT || 3000, '0.0.0.0', (err, address) => {
        if (err) {
            fastify.log.error(err)
            process.exit(1)
        }
        fastify.log.info(`server listening on ${address}`)
    })
    
  • Procfile 配置冗余引发进程冲突
    现有Procfile同时定义了两个完全相同的进程入口:
    web: node src/index.js
    worker: node src/index.js
    
    两个进程会抢占平台分配的同一个端口,直接触发端口占用冲突崩溃。其中web进程是专门处理HTTP请求的服务入口,worker的定位是运行无HTTP交互的后台任务,无需把同一个HTTP服务重复注册为worker进程。
    修正后的Procfile仅保留web进程即可,因为package.json已经配置了生产启动脚本,还可以进一步简化配置:
    web: npm start
    
  • 依赖分组不规范
    nodemon是开发环境使用的热更新工具,属于开发依赖,目前被放在生产依赖dependencies分组下,会导致线上环境安装不必要的冗余包,调整到devDependencies分组下即可。

部署验证

完成上述修正后,本地执行npm start确认服务能正常启动,日志输出server listening on http://0.0.0.0:对应端口后再重新部署,平台健康检查校验通过后就不会再出现H10报错和503错误。

内容的提问来源于stack exchange,提问作者Paul

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 08:24:01