Nest.js继承控制器时@UseGuards访问this报Object is possibly 'undefined'错误

TypeScript 装饰器在类声明阶段就会执行计算，此时控制器实例还未完成初始化，this 并不指向控制器实例，自然无法访问到实例上继承的_target属性，这是报错的本质原因。

该方案完全符合Nest的设计规范，不需要破坏原有继承逻辑，也不用调整Guard的核心实现。

步骤1：定义元数据键与自定义装饰器 #

先创建用来存储target的元数据键，以及简化设置的装饰器：

import { SetMetadata } from '@nestjs/common';

export const ROLES_TARGET_KEY = 'roles_target';
export const RolesTarget = (target: string) => SetMetadata(ROLES_TARGET_KEY, target);

步骤2：改造RolesGuard #

移除构造函数的target参数，注入Reflector来从路由/控制器上读取元数据：

import { Injectable, CanActivate, ExecutionContext, Reflector } from '@nestjs/common';
import { ROLES_TARGET_KEY } from './roles-target.decorator';

@Injectable()
export class RolesGuard implements CanActivate {
  constructor(private reflector: Reflector) {}

  canActivate(context: ExecutionContext): boolean | Promise<boolean> | Observable<boolean> {
    // 优先取路由方法上的target，没有则取控制器类上的target
    const target = this.reflector.getAllAndOverride<string>(ROLES_TARGET_KEY, [
      context.getHandler(),
      context.getClass(),
    ]);
    return this.myControlMethod(context, target);
  }

  // 其余原有逻辑保持不变
}

步骤3：调整控制器代码 #

不需要再在@UseGuards里传参，直接在子类控制器上加@RolesTarget装饰器传入对应值即可，原有继承逻辑完全保留：

@Controller('ChildController')
@RolesTarget('child') // 在这里传入target
export class ChildController extends BaseController {
  constructor() {
   super('child')
  }

  @Post()
  @UseGuards(AuthGuard('checkAccess'), RolesGuard) // 直接传入Guard类，不需要手动new
  async create(@Req() req: Request, @Res() res: Response, @Body() newItem: any) {
    // 原有方法逻辑保持不变
  }
}

如果希望进一步复用逻辑，也可以直接在BaseController层面统一处理元数据设置，子类只需要传_target即可，不需要重复加装饰器：

import { Controller } from '@nestjs/common';
import { RolesTarget } from './roles-target.decorator';

export function BaseController(target: string) {
  @Controller()
  @RolesTarget(target)
  class BaseControllerHost {
    protected _target = target;
  }
  return BaseControllerHost;
}

// 子类使用时
export class ChildController extends BaseController('child') {
  // 不需要再手动传target加装饰器
}

如果不想引入反射逻辑，也可以把_target改为类静态属性，静态属性在类声明阶段就已存在，可以直接在装饰器中访问：

// 基础控制器
@Controller()
export class BaseController {
  protected static _target: string;
}

// 子类控制器
@Controller('ChildController')
export class ChildController extends BaseController {
  protected static _target = 'child';

  @Post()
  @UseGuards(new AuthGuard('checkAccess'), new RolesGuard(ChildController._target)) // 直接访问类静态属性
  async create(@Req() req: Request, @Res() res: Response, @Body() newItem: any) {
    // 原有逻辑不变
  }
}

该方案实现更简单，但静态属性无法在实例方法中通过this访问，需要通过类名访问，适合简单场景使用。

内容的提问来源于stack exchange，提问作者Raphaël Balet