You need to enable JavaScript to run this app. 如何在NestJS与Passport中自定义OAuth2授权拒绝的错误响应
优惠活动
大模型
产品
解决方案
定价
更多

如何在NestJS与Passport中自定义OAuth2授权拒绝的错误响应

问题描述

我使用自定义Passport策略,希望当客户端拒绝OAuth应用授权时,能向客户端返回自定义错误信息。

当前授权流程

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 21:36:03