如何在NestJS与Passport中自定义OAuth2授权拒绝的错误响应
问题描述
我使用自定义Passport策略,希望当客户端拒绝OAuth应用授权时,能向客户端返回自定义错误信息。
当前授权流程

我期望在用户拒绝授权时返回定制化错误消息,而非默认的500错误;目前用户正常授权时流程可以正常运行。
我参考了NestJS官方文档中扩展守卫的实现方法,官方示例代码如下:
import { ExecutionContext, Injectable, UnauthorizedException, } from '@nestjs/common'; import { AuthGuard } from '@nestjs/passport'; @Injectable() export class JwtAuthGuard extends AuthGuard('jwt') { canActivate(context: ExecutionContext) { // 可在此添加自定义鉴权逻辑 // 例如调用 super.logIn(request) 建立会话 return super.canActivate(context); } handleRequest(err, user, info) { // 可根据 err 或 info 参数抛出自定义异常 if (err || !user) { throw err || new UnauthorizedException(); } return user; } }
按照示例实现后没有达到预期效果,查看应用日志发现流程抛出的异常如下:
api_1 | [Nest] 5080 - 12/10/2020, 6:13:54 PM [RouterExplorer] Mapped {/users/sign-up/email, POST} route +0ms api_1 | [Nest] 5080 - 12/10/2020, 6:13:54 PM [RouterExplorer] Mapped {/users/sign-up/confirm-email, GET} route +0ms api_1 | [Nest] 5080 - 12/10/2020, 6:13:54 PM [NestApplication] Nest application successfully started +3ms api_1 | [Nest] 5080 - 12/10/2020, 6:14:00 PM [ExceptionsHandler] Object: api_1 | { api_1 | "name": "AuthorizationError", api_1 | "message": "", api_1 | "code": "access-denied", api_1 | "status": 500 api_1 | } api_1 | +6377ms
相关实现代码
meli.strategy.ts
import { Strategy } from 'passport-oauth2'; import { PassportStrategy } from '@nestjs/passport'; import { Injectable } from '@nestjs/common'; import UsersService from '@/users/users.service'; import MeliService from '@/meli/meli.service'; @Injectable() export class MeliStrategy extends PassportStrategy(Strategy, 'meli') { constructor( private usersService: UsersService, private meliService: MeliService, ) { super({ authorizationURL: `https://auth.mercadolivre.com.br/authorization?response_type=code&client_id=${process.env.MELI_APP_ID}`, tokenURL: 'https://api.mercadolibre.com/oauth/token', clientID: process.env.MELI_APP_ID, clientSecret: process.env.MELI_APP_SECRET, callbackURL: process.env.MELI_REDIRECT_URL, scope: 'authorization_code', }); } async validate(accessToken: string) { const userData = await this.meliService.getUserData(accessToken); let user = await this.usersService.findUserByMercadoLibre(userData); if (!user) { user = await this.usersService.signUpByMercadoLibre(userData); } return user; } } export default MeliStrategy;
meli-auth.guard.ts
import { BadRequestException, ExecutionContext, Injectable, } from '@nestjs/common'; import { AuthGuard } from '@nestjs/passport'; @Injectable() export default class MeliAuthGuard extends AuthGuard('meli') { canActivate(context: ExecutionContext) { // 可在此添加自定义鉴权逻辑 return super.canActivate(context); } handleRequest(err, user, info) { // 可根据 err 或 info 参数抛出自定义异常 if (err || !user) { throw err || new BadRequestException('Just a custom message...'); } return user; } }
解决方案
核心问题原因
自定义逻辑没有生效,来自两个执行链路的盲区:
- passport-oauth2检测到用户拒绝授权时,会抛出原生
AuthorizationError(code为access-denied)直接传入handleRequest方法。你的守卫逻辑是throw err || new BadRequestException(...),只要err存在就会抛出原始错误,根本不会触发后面的自定义异常逻辑 - 原生
AuthorizationError没有内置NestJS可识别的HTTP状态码,框架兜底会统一返回500错误
具体修复代码
修改meli-auth.guard.ts的handleRequest方法,对授权拒绝的场景做单独拦截:
handleRequest(err, user, info) { // 单独拦截用户拒绝授权的场景,返回自定义错误 if (err?.code === 'access-denied') { throw new BadRequestException('您已拒绝本次应用授权,无法完成登录流程'); } // 其他正常鉴权异常的处理逻辑保持不变 if (err || !user) { throw err || new UnauthorizedException('鉴权失败,请重新发起授权'); } return user; }
排坑提示
- 如果修改后逻辑仍然不触发,检查OAuth回调路由是否正确挂载了自定义的
MeliAuthGuard。如果路由上用的是默认的AuthGuard('meli'),自定义的handleRequest逻辑不会被执行 - 可选优化:可以在策略类的构造函数中,通过覆写
error方法统一拦截授权错误,效果和守卫层的拦截一致
内容的提问来源于stack exchange,提问作者Émerson Felinto
相关产品推荐
相关产品推荐

