如何给控制器接口应用@UseGuards(JwtAuthGuard)时按请求参数动态关闭守卫

架构老林

2026-9-28

@UseGuards 装饰器本身不支持直接传入条件判断，你可以通过以下两种可行方案实现需求：

方案一：自定义带条件判断的JWT守卫（无需修改现有路由结构）

直接继承你现有的JwtAuthGuard，在守卫内部根据路径参数决定是否执行JWT校验逻辑：

步骤1：编写自定义条件守卫

import { ExecutionContext, Injectable } from '@nestjs/common';
import { JwtAuthGuard } from './jwt-auth.guard'; // 替换为你实际的JwtAuthGuard文件路径

@Injectable()
export class ConditionalJwtAuthGuard extends JwtAuthGuard {
  canActivate(context: ExecutionContext) {
    const request = context.switchToHttp().getRequest();
    // 路径存在bar参数时直接放行
    if (request.params?.bar) {
      return true;
    }
    // 无参数时执行原有JWT校验逻辑
    return super.canActivate(context);
  }
}

步骤2：替换控制器上的守卫

把原代码的@UseGuards(JwtAuthGuard)替换为自定义的守卫即可：

@UseGuards(ConditionalJwtAuthGuard)
@Get("/foo/:bar?")
async get(@Param() param: RequestParamDto) {
  // 原有业务逻辑无需修改
}

方案二：拆分两个路由接口（逻辑更清晰，无耦合）

将带参数和不带参数的路由拆分为两个独立的接口，分别配置守卫规则，把公共业务逻辑抽成公共方法复用即可：

// 无参数的/foo接口，开启JWT校验
@UseGuards(JwtAuthGuard)
@Get("/foo")
async getFooWithoutParam() {
  return this.handleFooLogic();
}

// 带参数的/foo/:bar接口，不开启JWT校验
@Get("/foo/:bar")
async getFooWithParam(@Param() param: RequestParamDto) {
  return this.handleFooLogic(param);
}

// 抽离的公共业务逻辑
private handleFooLogic(param?: RequestParamDto) {
  // 原有业务逻辑
}