如何在Nest.js中为模块级路由配置AuthGuard（非全局/接口级）

要在业务模块（如ApplicationModule）级别统一应用AuthGuard，无需在每个控制器/路由手动添加，也不用全局注册，可通过NestJS的APP_GUARD提供者实现，具体步骤如下：

1. 模块内注册APP_GUARD #

直接在目标模块的providers数组中注册APP_GUARD，指定使用你的AuthGuard类。该守卫会自动作用于当前模块下的所有控制器及路由。

修改后的ApplicationModule代码：

import { Module, APP_GUARD } from '@nestjs/common';
import { SequelizeModule } from '@nestjs/sequelize';
import { Application } from './models/application.model';
import { ApplicationServices } from './application.services';
import { applicationProvider, shareProvider } from './providers';
import { ApplicationController } from './application.controller';
import { AuthGuard } from '../auth/auth.guard';

@Module({
  imports: [SequelizeModule.forFeature([Application])],
  providers: [
    ApplicationServices,
    ...applicationProvider,
    ...shareProvider,
    // 注册模块级守卫
    {
      provide: APP_GUARD,
      useClass: AuthGuard,
    },
  ],
  exports: [ApplicationServices],
  controllers: [ApplicationController],
})
export class ApplicationModule {}

2. 带参数的守卫实例化 #

如果AuthGuard需要传入verifyOptions配置，可使用useFactory动态创建实例，支持注入其他依赖：

@Module({
  imports: [SequelizeModule.forFeature([Application])],
  providers: [
    ApplicationServices,
    ...applicationProvider,
    ...shareProvider,
    {
      provide: APP_GUARD,
      useFactory: () => {
        // 根据模块需求配置verifyOptions
        const verifyOptions: VerifySessionOptions = {
          // 自定义配置项，如session验证规则等
        };
        return new AuthGuard(verifyOptions);
      },
      // 若需注入其他服务，可在inject数组声明
      // inject: [ConfigService]
    },
  ],
  exports: [ApplicationServices],
  controllers: [ApplicationController],
})
export class ApplicationModule {}

关键说明 #

• 每个业务模块（如ChatModule、ShareModule）可单独注册APP_GUARD，各自守卫仅作用于当前模块内的控制器，不会影响其他模块或全局路由。
• 模块内所有控制器路由会自动应用该守卫，无需再在@Controller()或路由方法上添加@UseGuards()装饰器。
• 若某路由需跳过守卫，可在对应方法上添加自定义@Public()装饰器（需在AuthGuard中识别该装饰器逻辑），或用@UseGuards()单独覆盖模块级配置。

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