NestJS passport-local认证返回401 Unauthorized错误排查与解决

问题分析与解决方案 #

1. 核心问题：请求参数字段不匹配

passport-local默认会从请求体中提取username和password两个字段传递给validate方法。如果你的前端请求时发送的是name而非username，就会导致validate中的username参数为空，进而查不到用户返回401。

解决方式二选一：

• 方式一：调整前端请求参数
  确保请求体包含username和password字段，示例：

  {
    "username": "user1",
    "password": "admin"
  }
  

• 方式二：在策略中自定义字段名
  在策略的super()调用里配置字段映射，指定用户名对应的字段为name：

  constructor(private userService: UserService) {
      // 自定义用户名字段为name，密码字段保持默认
      super({ usernameField: 'name' });
  }
  

  这样passport-local会自动从请求体读取name作为用户名参数。

2. 移除AppModule中重复的UserService注册

UsersModule已经导出了UserService，AppModule通过导入UsersModule即可使用该服务，无需在providers中重复注册（重复注册会创建多个实例，可能导致数据不一致）：

import { Module } from '@nestjs/common';
import { UsersModule } from './users/users.module';
import { AppController } from './app.controller';
import { AuthModule } from './auth/auth.module';

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

3. 修正策略类名称拼写错误

将PassportlocalStragey改为PassportLocalStrategy（规范驼峰命名，修正拼写错误）：

@Injectable()
export class PassportLocalStrategy extends PassportStrategy(Strategy) {
    // 原有逻辑保持不变
}

同时更新AuthModule中的对应导入和注册：

import { PassportLocalStrategy } from './passportlocal.auth';

@Module({
    imports: [UsersModule, PassportModule],
    providers: [PassportLocalStrategy],
})
export class AuthModule { }

4. 简化validate方法逻辑

既然已经在开头判断了user是否存在，后续无需重复判断：

async validate(username: string, password: string): Promise<any> {
    console.log('Here I go');
    const user = await this.userService.getUserByName(username);
    console.log('Got user', user);

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

    if (user.password !== password) {
        console.log('Password mismatch');
        throw new UnauthorizedException();
    }

    return user;
}

5. 验证请求格式

确保请求是POST方法，且请求体的Content-Type为application/json，否则passport-local无法正确解析参数。

测试验证 #

完成修改后，发送POST请求到/app：

• 若用方式一，请求体传username和password
• 若用方式二，请求体传name和password
  此时应能成功通过认证，返回"This is private msg"，且req.user会包含对应用户信息。

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