NestJS微服务控制器无法接收HTTP请求的问题排查

核心原因：NestJS微服务默认不开启HTTP监听 #

NestJS微服务默认基于消息协议（如Redis）实现服务间通信，不会自动启动HTTP服务器——即便你添加了@Controller装饰器，也无法接收HTTP请求。必须通过混合模式启动，同时开启HTTP服务与微服务通信能力。

具体修复步骤 #

1. 修改main.ts，启用混合模式 #

如果原代码仅启动了微服务，需调整为同时启动HTTP服务器和Redis微服务：

import { NestFactory } from '@nestjs/core';
import { MicroserviceOptions, Transport } from '@nestjs/microservices';
import { AppModule } from './app.module';

async function bootstrap() {
  // 创建HTTP应用实例
  const app = await NestFactory.create(AppModule);
  
  // 配置并连接Redis微服务
  app.connectMicroservice<MicroserviceOptions>({
    transport: Transport.REDIS,
    options: {
      host: 'redis', // 对应docker-compose中的Redis服务名
      port: 6379,
    },
  });

  // 启动所有服务（HTTP服务+Redis微服务）
  await app.startAllMicroservices();
  await app.listen(3000); // 监听HTTP端口，与你访问的3000端口对应
  console.log('HTTP server running on http://localhost:3000');
}
bootstrap();

2. 核对控制器路由配置 #

确保控制器路由与访问路径完全匹配。例如要访问/please_work，控制器代码需对应：

import { Controller, Get } from '@nestjs/common';

@Controller()
export class OfferController {
  @Get('please_work')
  getEndpointResponse(): string {
    return '请求成功！';
  }
}

如果控制器标注了@Controller('external')，则访问路径应为/external/please_work，需严格对应。

3. 验证Docker端口映射 #

检查docker-compose.yml中的端口映射规则，确保容器的HTTP端口（默认3000）映射到宿主机的3000端口：

services:
  your-microservice:
    build: .
    ports:
      - "3000:3000" # 格式：宿主机端口:容器内部端口
    depends_on:
      - redis
  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

如果容器内部使用了其他HTTP端口，需同步修改映射规则。

4. 确认启动日志信息 #

启动后检查日志，需同时出现以下内容：

• HTTP server running on http://localhost:3000（HTTP服务启动成功）
• Nest microservice successfully started（Redis微服务启动成功）
• 路由映射日志，例如GET /please_work (OfferController)

若日志仅显示微服务启动信息，说明混合模式配置未生效。

5. 排查Docker网络问题 #

• 用docker ps命令确认容器正常运行，端口映射状态正确
• 进入容器内部执行curl localhost:3000/please_work，验证容器内HTTP服务是否正常响应，排除宿主机到容器的网络阻塞
• 若存在多个微服务容器，确认请求发送到了包含目标控制器的容器实例

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