NestJS JWTAuthenticationGuard单元测试问题求助

核心问题分析 #

Passport的AuthGuard('jwt')在验证失败时会直接抛出UnauthorizedException，而非返回false，这是你测试时无法断言返回值的根本原因。另外，有效token测试失败大概率是因为测试环境中JWT验证的依赖（如密钥、策略）未正确模拟。

场景2：无效/过期token测试方案 #

直接捕获Guard抛出的异常，断言异常类型即可，无需纠结返回值：

it('should throw UnauthorizedException when token is invalid', async () => {
  // 模拟请求头，传入无效token
  const mockExecutionContext = createMockExecutionContext({
    headers: { authorization: 'Bearer invalid-token' },
  });

  await expect(authGuard.canActivate(mockExecutionContext)).rejects.toThrow(UnauthorizedException);
});

场景3：有效token测试方案 #

需要模拟Passport的JWT策略验证逻辑，让它返回合法用户：

1. 在测试模块中替换JWT策略为模拟实现：

beforeEach(async () => {
  const module: TestingModule = await Test.createTestingModule({
    providers: [
      JWTAuthenticationGuard,
      {
        provide: AuthService, // 若Guard依赖AuthService，需同步模拟
        useValue: { validateUser: jest.fn().mockResolvedValue({ id: 1, username: 'test' }) },
      },
      {
        provide: PassportStrategy,
        useValue: {
          validate: jest.fn().mockResolvedValue({ id: 1, username: 'test' }),
        },
      },
    ],
  }).compile();

  authGuard = module.get<JWTAuthenticationGuard>(JWTAuthenticationGuard);
});

2. 编写测试用例，传入有效token并断言返回true：

it('should return true when token is valid', async () => {
  // 生成真实有效token，或直接模拟请求头（因策略已被mock）
  const mockExecutionContext = createMockExecutionContext({
    headers: { authorization: 'Bearer valid-token' },
  });

  const result = await authGuard.canActivate(mockExecutionContext);
  expect(result).toBe(true);
});

辅助工具：模拟ExecutionContext #

封装工具函数快速创建模拟上下文，减少重复代码：

function createMockExecutionContext(requestData: any) {
  const mockRequest = { ...requestData };
  const mockExecutionContext = {
    switchToHttp: () => ({
      getRequest: () => mockRequest,
    }),
    getHandler: () => ({}),
    getClass: () => ({}),
  } as unknown as ExecutionContext;
  return mockExecutionContext;
}

关键注意点 #

• 不要试图让Guard返回false，Passport的AuthGuard设计就是验证失败时抛出异常，属于框架默认行为。
• 测试时必须正确模拟所有依赖，包括JWT策略、AuthService等，否则验证逻辑会走真实实现导致失败。

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