NestJS控制器未映射问题：导入模块后无法接收请求

排查与解决步骤 #

1. 确认控制器装饰器配置正确 #

确保控制器类上的@Controller装饰器拼写正确（大小写敏感），且至少配置空前缀或具体路由前缀：

import { Controller, Get } from '@nestjs/common';
import { OrderService } from './order.service';

@Controller('orders') // 或使用空前缀@Controller()
export class OrderController {
  constructor(private readonly orderService: OrderService) {}

  @Get()
  getOrders() {
    return this.orderService.getOrders();
  }
}

2. 验证模块与控制器的导入路径 #

检查OrderModule和ProductModule中，控制器的导入路径是否正确，避免拼写错误或相对路径错误：

// OrderModule.ts
import { Module } from '@nestjs/common';
import { OrderController } from './order.controller'; // 确认路径匹配实际文件位置
import { OrderService } from './order.service';

@Module({
  controllers: [OrderController],
  providers: [OrderService],
  exports: [OrderService],
})
export class OrderModule {}

3. 检查TypeScript编译配置 #

确保tsconfig.json的include字段包含所有源码文件，避免控制器文件未被编译：

{
  "compilerOptions": {
    // 保留原有编译配置
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

4. 清理编译产物并重新构建 #

若控制器文件已修改但未被正确编译，可删除dist目录后重新构建启动：

rm -rf dist
npm run build
npm run start:dev

5. 验证启动日志 #

正常情况下，服务启动后日志应出现类似以下内容，说明控制器已成功映射：

LOG [RoutesResolver] OrderController {/orders}: +0ms
LOG [RouterExplorer] Mapped {/orders, GET} route +1ms

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