NestJS服务端契约验证测试返回404问题排查咨询

一、相同请求下Pact返回404、手动请求正常的可能原因 #

• HTTP方法大小写不匹配：NestJS的@Put()装饰器只匹配大写的PUT请求，如果Pact测试里定义的请求方法是小写的put，会导致路由匹配失败。
• URL路径斜杠差异：Express默认严格匹配路径末尾的斜杠，比如NestJS路由定义为@Put('users/:id')，Pact请求/users/1/（带末尾斜杠）会匹配失败，而手动请求/users/1则正常。
• 全局/模块路由前缀遗漏：如果你的NestJS应用设置了全局前缀（比如app.setGlobalPrefix('v1')）或者模块路由前缀（@Controller('users')），但Pact请求时未带上对应的前缀，会导致路径不匹配。
• 请求头缺失关键字段：比如Pact请求未携带Content-Type: application/json，body-parser无法解析请求体，可能间接影响路由匹配逻辑（虽然404更多是路径问题，但需排查）。
• 服务实例不一致：即使移除了server.close()，也要确认Pact测试中启动的服务是否和手动测试的是同一个实例——比如Pact可能在不同端口启动，或者测试代码的服务启动逻辑存在问题，导致路由未正确注册。

二、调试NestJS/Express路由匹配的实用方法 #

• 添加全局中间件打印请求详情：在main.ts中加入中间件，打印Pact请求的实际方法、URL、请求头，和手动请求做对比：

  app.use((req, res, next) => {
    console.log(`[DEBUG] 收到请求: ${req.method} ${req.originalUrl}`);
    console.log(`[DEBUG] 请求头:`, req.headers);
    next();
  });
  

• 用@All()捕获未匹配请求：在根控制器中添加全局捕获方法，查看所有未匹配成功的请求信息：

  @Controller()
  export class CatchAllController {
    @All('*')
    catchAll(@Req() req: Request) {
      console.log(`[UNMATCHED] 请求方法: ${req.method}, 请求路径: ${req.path}`);
      throw new NotFoundException();
    }
  }
  

• 打印所有已注册路由：启动服务后，打印Express的路由栈，确认已注册的路由规则是否符合预期：

  async function bootstrap() {
    const app = await NestFactory.create(AppModule);
    // 其他配置代码
    await app.listen(3000);
  
    // 打印所有注册路由
    const server = app.getHttpServer();
    const router = server._router;
    router.stack.forEach((layer: any) => {
      if (layer.route) {
        const methods = Object.keys(layer.route.methods).join(',').toUpperCase();
        console.log(`[REGISTERED] ${methods} ${layer.route.path}`);
      }
    });
  }
  

• 启用NestJS verbose日志：创建应用时开启详细日志，查看路由注册的全过程，确认路由是否正确加载：

  const app = await NestFactory.create(AppModule, {
    logger: ['verbose'],
  });
  

• 断点调试：在NestJS的路由守卫或全局中间件中设置断点，直接查看req.method、req.path等核心属性，对比路由规则的匹配逻辑。

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