Nest.js应用在DigitalOcean App平台start:prod部署失败求助

根据你提供的启动日志和应用配置，以下是针对性的排查思路和解决方案：

1. 确认应用监听端口与平台配置一致 #

DigitalOcean App平台配置的http_port是8080，但你的启动日志中没有显示Nest应用监听端口的常规输出（正常情况下Nest会打印Listening on port X的日志）。

• 检查src/main.ts中的启动代码，确保应用监听的是8080端口，或正确读取平台注入的环境变量：

  // 推荐写法：优先使用平台提供的PORT环境变量
  await app.listen(process.env.PORT || 8080);
  

2. 排查健康检查失败问题 #

DigitalOcean App平台会自动执行健康检查，若应用无法响应检查请求，会直接标记部署失败：

• 验证根路径响应：本地启动应用后访问http://localhost:8080，确认返回200状态码和有效内容。
• 添加专门的健康检查端点（更可靠）：在AppController中新增健康路由，确保返回标准成功响应：

  import { Controller, Get } from '@nestjs/common';
  
  @Controller()
  export class AppController {
    @Get('health')
    getHealthStatus() {
      return { status: 'healthy', timestamp: new Date().toISOString() };
    }
  }
  

• 在DigitalOcean控制台的应用配置中，将健康检查路径设置为/health，并延长超时时间（如调整为30秒），避免因应用启动初期资源未就绪导致检查失败。

3. 确保应用进程前台运行 #

DigitalOcean要求应用进程保持前台运行，若进程后台化，平台会判定进程退出：

• 检查package.json中的start:prod脚本，确保是直接执行node命令，无后台运行参数（如&）或PM2等第三方进程管理工具：

  "scripts": {
    "start:prod": "node dist/src/main"
  }
  

4. 捕获隐藏的运行时错误 #

日志显示应用启动成功，但可能存在未被捕获的异步错误（如数据库连接静默重试），导致平台健康检查超时：

• 在main.ts中添加全局错误捕获，输出所有未处理异常：

  process.on('unhandledRejection', (reason, promise) => {
    console.error('未处理的Promise拒绝:', promise, '原因:', reason);
  });
  
  process.on('uncaughtException', (error) => {
    console.error('未捕获的异常:', error);
    process.exit(1);
  });
  

• 重新部署后查看完整日志，确认是否存在隐藏错误。

5. 调整平台部署超时设置 #

若应用启动较慢（如依赖数据库连接初始化），DigitalOcean的默认部署超时可能提前判定失败：

• 登录DigitalOcean控制台，进入应用配置页面，找到「部署」相关设置，延长部署超时时间（如设置为5分钟）。

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