如何在NestJS中将Passport Local Guard验证结果绑定到@Body参数？

问题描述 #

基于NestJS框架按官方文档实现了集成Passport的认证模块，后续完成了代码重构与类型补充。团队代码规范要求控制器接口必须通过@Body()装饰器接收请求体参数，例如：

async createUser(@Body() createUserDto: CreateUserDto)

当前登录接口采用官方示例写法：

@UseGuards(AuthGuard('local'))
@Post('auth/login')
async login(@Request() req) {
  return req.user;
}

希望将@Request()改为@Body()装饰器，让AuthGuard('local')把验证后的用户信息传递给@Body指定的参数。尝试在PassportModule中配置property: 'signInDto'但未生效，请问能否通过默认Passport Local Guard实现该需求？若不能，该如何实现？

解决方案 #

默认的Passport Local Guard无法直接实现这个需求，原因如下：

• @Body()装饰器的作用是绑定客户端发送的原始HTTP请求体数据，由Nest的BodyParser中间件处理。
• Passport的AuthGuard('local')验证通过后，默认会将用户信息挂载到req.user属性上（或通过property配置指定的req属性），但这和@Body()获取的请求体是完全独立的数据源，所以修改property配置无法影响@Body()的取值。

要实现需求，可以通过自定义Local Guard来修改请求体，将验证后的用户信息注入到请求体中，具体步骤如下：

1. 自定义继承自AuthGuard('local')的Guard：

import { Injectable } from '@nestjs/common';
import { AuthGuard } from '@nestjs/passport';

@Injectable()
export class CustomLocalAuthGuard extends AuthGuard('local') {
  handleRequest(err, user, info, context) {
    const request = context.switchToHttp().getRequest();
    // 将验证后的用户信息附加到请求体的指定字段（比如user）
    request.body.user = user;
    // 调用父类方法完成后续逻辑
    return super.handleRequest(err, user, info, context);
  }
}

2. 在控制器中使用自定义Guard，并通过@Body()获取包含用户信息的请求体：

// 假设SignInDto是客户端传入的登录参数DTO，User是验证后的用户类型
@UseGuards(CustomLocalAuthGuard)
@Post('auth/login')
async login(@Body() signInDto: SignInDto & { user: User }) {
  return signInDto.user;
}

如果希望@Body()直接返回用户信息（而非合并原始请求体），可以在自定义Guard中直接替换请求体：

handleRequest(err, user, info, context) {
  const request = context.switchToHttp().getRequest();
  // 直接将请求体替换为验证后的用户
  request.body = user;
  return super.handleRequest(err, user, info, context);
}

此时控制器可以简化为：

@UseGuards(CustomLocalAuthGuard)
@Post('auth/login')
async login(@Body() user: User) {
  return user;
}

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