NestJS全局拦截器未正常生效？问题排查求助

先排查拦截器自身实现问题 #

所有拦截器必须满足两个核心条件才会被NestJS识别并执行：

1. 必须添加@Injectable()装饰器
2. 正确实现NestInterceptor接口的intercept方法，示例如下：

import { Injectable, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
import { Observable } from 'rxjs';

@Injectable()
export class UuidInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    // 可添加日志验证是否触发
    console.log('UuidInterceptor 已执行');
    // 必须返回next.handle()，否则请求会被中断
    return next.handle();
  }
}

如果漏加@Injectable()或者未返回next.handle()，拦截器肯定不会生效。

区分HTTP请求和微服务消息的处理逻辑 #

你的应用同时启动了HTTP服务和NATS微服务，两者的拦截器注册逻辑是相互独立的，需要分别处理：

针对HTTP请求的修复 #

1. 确认InterceptorsModule已正确导入到AppModule的imports数组中，比如：

@Module({
  imports: [InterceptorsModule],
  // ...其他模块配置
})
export class AppModule {}

2. 如果用useGlobalInterceptors，要保证调用顺序在app.listen()之前，顺序错误可能导致配置失效：

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
  // 先注册全局拦截器
  app.useGlobalInterceptors(new UuidInterceptor(), new RetryInterceptor(), new TimeoutInterceptor(), new LoggerErrorInterceptor());
  // 再配置CORS、日志、管道等其他内容
  app.enableCors({ credentials: true, origin: true });
  app.useLogger(app.get(Logger));
  app.useGlobalPipes(new ValidationPipe());
  // ...后续微服务配置和启动流程
}

针对NATS微服务消息的修复 #

connectMicroservice创建的是独立的微服务实例，HTTP服务的全局配置不会自动同步过去，需要单独为微服务注册拦截器：

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
  // ...HTTP服务相关配置

  // 创建微服务时保存实例引用
  const microservice = app.connectMicroservice({
    transport: Transport.NATS,
    options: {
      servers: [process.env.NATS_SERVER_URL!],
      queue: 'PLAYER',
    },
  });

  // 给微服务单独注册全局拦截器
  microservice.useGlobalInterceptors(new UuidInterceptor(), new RetryInterceptor(), new TimeoutInterceptor(), new LoggerErrorInterceptor());

  await app.startAllMicroservices();
  await app.listen(configService.port, '0.0.0.0');
}

如果你的请求是发往NATS微服务的，必须完成这一步配置，否则拦截器不会触发。

额外排查点 #

• 检查是否有其他模块或全局配置覆盖了当前拦截器
• 确保应用启动时没有依赖注入报错，注入失败会导致拦截器无法初始化

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