多overrideGuard配置导致NestJS Jest测试失败问题排查

你遇到的问题并非后续的overrideGuard直接取消了之前的覆写，而是NestJS测试工具的Guard覆写特性，加上你的mock Guard逻辑协作问题共同导致的：

核心原因拆解 #

1. overrideGuard的行为特性
   overrideGuard(GuardClass)是针对单个Guard类做替换，多次调用不会互相覆盖。但如果你的路由上同时绑定了多个Guard（比如@UseGuards(AuthGuard, ACGuard)），覆写其中一个后，另一个Guard的逻辑依然会执行。你看到的500错误，本质是acGuard mock的逻辑有问题，而非之前的AuthGuard覆写被取消。

2. 错误提示的本质
   Invalid role(s): []说明ACGuard没有拿到预期的用户角色——而角色通常是由AuthGuard解析后附加到req.user中的。如果你的mockAuthGuard正确模拟了用户信息，但acGuard mock没有正确读取或处理这些角色，就会抛出这个错误。

3. 移除ACGuard覆写后正常的原因
   不覆写ACGuard时，你用的是原有ACGuard，它能正确从AuthGuard解析的req.user中获取角色；但覆写为acGuard mock后，这个mock没有实现正确的角色校验逻辑（比如没读取req.user的角色，或模拟的角色为空），导致报错。

如果确实出现了之前的AuthGuard覆写被取消的情况，大概率是你误用了复数形式的overrideGuards：
overrideGuards(ACGuard).useValue(acGuard)会直接替换路由上的所有Guard，只保留acGuard，之前的AuthGuard覆写会被丢弃，原AuthGuard生效后无法正确设置用户信息，最终导致ACGuard拿到空角色抛出错误。

解决方案 #

1. 正确覆写多个Guard
   如果需要同时替换多个Guard，用复数形式的overrideGuards，传入所有要替换的Guard类，并对应传入mock实例：

const moduleFixture = await Test.createTestingModule({
  imports: [AppModule],
})
.overrideGuards(AuthGuard, ACGuard)
.useValues(mockAuthGuard, acGuard)
.compile();

2. 修正acGuard mock逻辑
   确保mock的ACGuard能正确读取AuthGuard设置的用户角色，比如：

const acGuard = {
  canActivate: (context: ExecutionContext) => {
    const req = context.switchToHttp().getRequest();
    // 模拟存在合法角色的场景
    req.user = { roles: ['admin'] };
    return true;
  },
};

3. 避免误用覆写方法
   单独覆写单个Guard时，务必使用单数的overrideGuard，不要用overrideGuards，防止意外替换整个Guard列表。

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