NestJS中如何根据运行环境配置AuthGuard的动态角色值

TS字符串枚举不支持计算值，用as const声明的常量对象可以完全替代枚举的类型提示能力，同时支持动态赋值：

// src/constants/role.constant.ts
const isProdEnv = process.env.NODE_ENV === 'production';

export const Role = {
  team1: isProdEnv ? 'team1Prod' : 'team1QA',
  team2: isProdEnv ? 'team2Prod' : 'team2QA',
} as const;

// 导出类型，和原生枚举的使用体验完全一致
export type Role = typeof Role[keyof typeof Role];

用法和原来的枚举完全一致，既可以当值用Role.team1，也可以当类型用const role: Role = Role.team2。

如果要完全在应用启动阶段根据环境生成全局可用的角色配置，用Nest的自定义Provider实现，不需要依赖顶层环境变量的计算，也更方便单元测试：

• 第一步：定义角色接口和注入令牌

// src/roles/roles.constants.ts
export const ROLES = Symbol('ROLES');

export interface RolesConfig {
  team1: string;
  team2: string;
}

• 第二步：在根模块注册动态Provider

// src/app.module.ts
import { Module } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';
import { ROLES, RolesConfig } from './roles/roles.constants';

@Module({
  providers: [
    {
      provide: ROLES,
      useFactory: (configService: ConfigService): RolesConfig => {
        const isProd = configService.get('NODE_ENV') === 'production';
        return {
          team1: isProd ? 'team1Prod' : 'team1QA',
          team2: isProd ? 'team2Prod' : 'team2QA',
        }
      },
      inject: [ConfigService]
    }
  ],
  exports: [ROLES]
})
export class AppModule {}

• 第三步：在AuthGuard中注入使用

// src/guards/roles.guard.ts
import { Injectable, CanActivate, ExecutionContext, Inject } from '@nestjs/common';
import { ROLES, RolesConfig } from '../roles/roles.constants';

@Injectable()
export class RolesGuard implements CanActivate {
  constructor(@Inject(ROLES) private readonly roles: RolesConfig) {}

  canActivate(context: ExecutionContext): boolean {
    // 此处直接用this.roles.team1、this.roles.team2做权限校验即可
    const requiredRoles = this.reflector.getAllAndOverride<Role[]>(ROLES_KEY, [
      context.getHandler(),
      context.getClass(),
    ]);
    // 后续校验逻辑和官方示例一致，仅替换角色取值来源
  }
}

如果不想改动现有枚举的使用逻辑，直接通过构建工具的路径别名配置，不同环境加载不同的枚举文件：

• 你现有两个文件：role.qa.ts、role.prod.ts
• 在tsconfig.json中配置路径别名：

{
  "compilerOptions": {
    "paths": {
      "@/enums/role": ["./src/enums/role.qa.ts"]
    }
  }
}

• 生产构建时通过tsconfig-paths或者打包工具（Webpack/Vite）的别名配置，将@/enums/role映射到role.prod.ts即可，代码中直接导入import { Role } from '@/enums/role'即可自动适配环境。

方案对比 #

• 方案1适合小型项目，改动最少，无需调整现有权限逻辑
• 方案2适合中大型项目，符合Nest的DI规范，支持单元测试时自定义角色配置
• 方案3适合不想调整现有代码逻辑，已经维护了两套枚举文件的场景

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