Docker Compose中NestJS应用健康检查失效问题排查求助

问题现象 #

使用Docker Compose部署NestJS应用时，后端容器始终被标记为unhealthy，已通过Terminus配置健康检查路由，但问题依旧。

排查与修复步骤 #

1. 容器内缺少curl命令 #

大部分Node.js官方镜像（尤其是alpine版本）默认未安装curl，健康检查的curl -f http://localhost:3009命令会直接失败，导致容器被标记为不健康。

解决方法二选一：

• 在构建后端镜像的Dockerfile中添加curl安装步骤：

  # 基于debian/ubuntu的node镜像
  RUN apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/*
  
  # 基于alpine的node镜像
  RUN apk add --no-cache curl
  

• 替换健康检查命令为Node.js内置HTTP请求，无需额外安装工具：

  healthcheck:
    test: ["CMD", "node", "-e", "require('http').get('http://localhost:3009', (res) => { process.exit(res.statusCode === 200 ? 0 : 1) }).on('error', () => { process.exit(1) })"]
    interval: 15s
    timeout: 5s
    retries: 3
  

2. 健康检查路由逻辑冗余且无效 #

当前控制器中的健康检查是循环ping自身接口，不仅无法反映应用实际健康状态（比如数据库连接是否正常），还可能在应用启动初期因自身未完全就绪导致检查失败。

修复方案：
改为检查核心依赖（如PostgreSQL数据库）的状态，示例代码（需确保已引入@nestjs/terminus和对应的数据库健康指示器，比如TypeORM）：

import { Controller, Get } from '@nestjs/common';
import { HealthCheck, HealthCheckService, TypeOrmHealthIndicator } from '@nestjs/terminus';

@Controller()
export class AppController {
  constructor(
    private health: HealthCheckService,
    private typeOrm: TypeOrmHealthIndicator,
  ) {}

  @Get()
  @HealthCheck()
  check() {
    return this.health.check([
      // 检查数据库连接状态
      () => this.typeOrm.pingCheck('database'),
    ]);
  }
}

3. NestJS应用监听地址限制 #

确保NestJS应用监听0.0.0.0而非localhost，否则容器内的请求可能无法访问到应用：

// main.ts
async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 绑定0.0.0.0允许容器内外部访问
  await app.listen(process.env.PORT, '0.0.0.0');
}
bootstrap();

4. 健康检查参数调整 #

默认的interval:10s和retries:2可能给应用的启动和依赖初始化时间不足，建议调整为：

healthcheck:
  # ... test命令 ...
  interval: 15s
  timeout: 5s
  retries: 3

内容的提问来源于stack exchange，提问作者Rocky Operation