Nest.js使用AuthGuard持续返回401未授权问题求助

核心问题分析 #

你的代码存在三个关键问题，导致LocalStrategy的validate函数未执行且返回401：

1. Passport LocalStrategy参数与字段配置错误 #

passport-local默认从请求中读取username和password全小写字段，但你的请求体传递的是首字母大写的Username和Password，同时validate函数错误地接收payload对象而非预期的独立参数。

修复方法：
修改local.strategy.ts，指定匹配的请求字段名并修正validate参数：

import { Strategy } from 'passport-local';
import { PassportStrategy } from '@nestjs/passport';
import { Injectable, UnauthorizedException } from '@nestjs/common';
import { AuthService } from '../auth.service';

@Injectable()
export class LocalStrategy extends PassportStrategy(Strategy) {
  constructor(private authService: AuthService) {
    // 指定请求体中的字段名，匹配前端传递的参数
    super({
      usernameField: 'Username',
      passwordField: 'Password',
    });
  }

  // 正确接收username和password两个独立参数
  async validate(username: string, password: string): Promise<any> {
    console.log('user', username, password);
    const user = await this.authService.validateUser(username, password);

    if (!user) {
      throw new UnauthorizedException();
    }

    return user;
  }
}

2. AuthService的login方法逻辑缺陷 #

当前login方法在密码不匹配时无返回值，会导致validate函数接收到undefined进而抛出异常；同时login方法不应同时承担用户验证和token生成的职责，需要拆分逻辑。

修复方法：
在AuthService中新增验证用户的方法，拆分token生成逻辑：

@Injectable()
export class AuthService {
  // ... 其他代码

  // 新增：仅负责验证账号密码合法性
  async validateUser(username: string, password: string): Promise<any> {
    try {
      const user = await this.AuthModel.findOne({ Username: username }).exec();
      if (!user) return null;
      // 生产环境必须用bcrypt等哈希算法替代明文比较！
      if (user.Password === password) {
        // 返回用户信息时剔除敏感的密码字段
        const { Password, ...safeUser } = user.toObject();
        return safeUser;
      }
      return null;
    } catch (error) {
      console.error('Error validating user:', error);
      return null;
    }
  }

  // 修改：仅接收验证通过的用户信息，生成token
  async login(user: any) {
    const payload = { username: user.Username, sub: user._id };
    return {
      accessToken: this.JwtService.sign(payload),
    };
  }

  // ... 其他代码
}

3. 控制器login方法的冗余逻辑 #

使用LocalGuard后，Passport已经通过LocalStrategy完成用户验证，验证通过的用户会挂载到request.user上，无需手动调用authService.login。

修复方法：
修改AuthController的login方法：

// 先导入Req装饰器
import { Controller, Get, Post, Body, Patch, Param, Delete, UseGuards, Req } from '@nestjs/common';

@Controller('auth')
export class AuthController {
  // ... 其他代码

  @Post('login')
  @UseGuards(LocalGuard)
  async login(@Req() req) {
    // 直接使用Guard验证后的用户信息生成token
    return this.authService.login(req.user);
  }

  // ... 其他代码
}

额外注意事项 #

• 生产环境绝对禁止明文存储和比较密码，必须使用bcrypt等哈希算法加密处理。
• 确保请求体参数名与Strategy中配置的usernameField、passwordField完全一致。
• 若无需额外逻辑，LocalGuard可直接继承AuthGuard('local')，无需重写canActivate方法。

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