Angular/NestJS/PostgreSQL应用角色守卫失效及报错排查

核心问题定位 #

报错TypeError: Cannot read properties of undefined (reading 'roles')直接说明request.user是undefined，也就是角色守卫执行时，请求对象里还未注入用户身份信息。这是因为NestJS守卫按注册顺序执行，若RolesGuard在身份验证守卫（如JWT的AuthGuard）之前运行，就会触发该错误。

分步解决方案 #

1. 修正守卫执行顺序 #

在getuserlist()接口的控制器装饰器中，必须先执行身份验证守卫，再执行角色守卫，确保request.user被正确注入后再做角色校验：

@Get('getuserlist')
@UseGuards(AuthGuard('jwt'), RolesGuard) // AuthGuard在前，先完成用户身份验证并注入request.user
@Roles(Role.Admin) // 指定接口仅允许Admin角色访问
getUserList() {
  // 接口业务逻辑
}

2. 给RolesGuard添加空值防护 #

在roles.guard.ts中增加对user的存在性判断，避免因用户未登录导致的报错：

@Injectable()
export class RolesGuard implements CanActivate {
  constructor(private reflector: Reflector) {}
  canActivate(context: ExecutionContext): boolean {
    const requireRoles = this.reflector.getAllAndOverride<Role[]>(ROLES_KEY, [
      context.getHandler(),
      context.getClass(), 
    ]);
  
    if (!requireRoles) {
      return true;
    }

    const request = context.switchToHttp().getRequest();
    const user = request.user;

    // 新增：若用户未登录（user不存在），直接拒绝访问
    if (!user) {
      return false;
    }

    return requireRoles.some((role) => user.roles.includes(role));
  } 
}

3. 验证JWT策略的用户信息注入 #

检查你的JWT策略文件（通常为jwt.strategy.ts）的validate方法，确保返回的用户对象包含roles字段，这样request.user才能拿到角色信息：

async validate(payload: any) {
  // 从数据库查询用户，确保返回结果包含roles字段
  const user = await this.userService.findOne(payload.sub);
  if (!user) {
    throw new UnauthorizedException();
  }
  // 返回的对象会自动注入到request.user中
  return { id: user.id, roles: user.roles, email: user.email };
}

4. 确认角色装饰器配置正确 #

确保roles.decorator.ts的实现符合NestJS元数据规范：

import { SetMetadata } from '@nestjs/common';
import Role from './role.enum';

export const ROLES_KEY = 'roles';
export const Roles = (...roles: Role[]) => SetMetadata(ROLES_KEY, roles);

额外检查项 #

• 确认AuthGuard已全局注册或在目标控制器/接口上正确使用
• 验证前端请求时是否携带有效JWT令牌，且令牌解码后包含用户角色信息
• 检查数据库中用户的roles字段是否为数组类型，且正确存储Admin/User枚举值

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