NestJS中Auth Guard路由访问失败，Local Strategy的validate函数未执行

以下是几种常见的排查方向和解决方案：

1. 检查Passport Local策略的字段匹配 #

passport-local默认会从请求中读取username和password字段作为凭证。如果你的前端请求中使用的是其他字段名（比如email代替username），策略会因无法获取到凭证直接返回401，根本不会进入validate方法。

解决方案：在LocalStrategy的构造函数中，通过super()指定自定义字段名：

// ./auth/local.strategy.ts
constructor(private authService: AuthService) {
  // 如果用email作为用户名字段，添加以下配置
  super({ usernameField: 'email' });
}

2. 确认AuthModule的配置完整性 #

如果LocalStrategy没有被正确注册到模块中，或者没有导入PassportModule，LocalAuthGuard会找不到对应的策略，直接返回401。

检查AuthModule是否包含以下内容：

// ./auth/auth.module.ts
import { Module } from '@nestjs/common';
import { PassportModule } from '@nestjs/passport';
import { AuthService } from './auth.service';
import { LocalStrategy } from './local.strategy';

@Module({
  imports: [PassportModule],
  providers: [AuthService, LocalStrategy], // 必须注册LocalStrategy
  exports: [AuthService], // 如果其他模块需要AuthService，需导出
})
export class AuthModule {}

同时确保AppModule已经导入了AuthModule，否则AppController无法注入AuthService和使用LocalAuthGuard：

// ./app.module.ts
import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { AuthModule } from './auth/auth.module';

@Module({
  imports: [AuthModule],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

3. 验证请求数据格式是否正确 #

NestJS无法正确解析请求体时，会导致策略拿不到用户名和密码，触发401：

• 如果使用JSON格式请求，确保请求头设置了Content-Type: application/json，且请求体结构正确：

  {
    "username": "your-username",
    "password": "your-password"
  }
  

• 如果使用表单格式（x-www-form-urlencoded），确保参数名和策略期望的字段一致（默认username/password）。

4. 确认Request装饰器的导入 #

你的login方法中使用了@Request()，需要确保导入了正确的类型：

// ./app.controller.ts
import { Request } from 'express'; // 导入express的Request类型
// 或者使用@nestjs/common提供的@Req装饰器
import { Req } from '@nestjs/common';

// 替换@Request()为@Req()
async login(@Req() req) {
  return req.user;
}

额外排查点 #

• 检查是否有全局守卫或拦截器提前拦截了请求，导致LocalAuthGuard未生效。
• 确认AuthService的validateUser方法逻辑是否正确，但根据你的描述，validate函数根本没执行，所以问题大概率不在这一步。

内容的提问来源于stack exchange，提问作者Victor Santos de Bustamante