Nest.js+Passport.js Google OAuth2登录异常排查求助

问题核心 #

你当前的异常源于用XHR/fetch发起OAuth登录请求的错误方式：OAuth2授权码流程依赖浏览器完整的页面跳转来维护跨域会话（比如Google的授权状态Cookie），而XHR请求无法处理跨域重定向跳转。当Google自动完成授权并重定向到回调接口时，XHR会尝试解析这个非JSON的跳转响应，最终抛出异常。

修复方案 #

1. 前端：替换XHR请求为浏览器原生跳转 #

把原来的fetch调用直接替换为页面跳转，这是OAuth登录的标准触发方式：

// 替换原req()调用
window.location.href = `${appConfig.apiBasePath}/auth/login/google`;

或者用HTML标签直接触发：

<a href="/auth/login/google">Google登录</a>

2. 后端：调整登录接口为GET请求（规范优化） #

OAuth登录发起接口通常用GET请求（无请求体的跳转操作），修改控制器代码：

@Controller('auth')
export class AuthController {
  // 将POST改为GET
  @Get('login/google')
  @UseGuards(AuthGuard('google'))
  oauthGoogle() {}

  // 回调接口保持原有逻辑不变
  @Get('login/google/success')
  @UseGuards(AuthGuard('google'))
  async oauthGoogleSuccess(
    @Auth() user: UserDocument,
    @Res({ passthrough: true }) res: Response,
  ): Promise<void> {
    const data = await this.authService.generateLogin(user);
    res.cookie('token', data.token);
    res.redirect(this.config.getOrThrow('APP_HOME'));
  }
}

3. 确保强制授权弹窗生效（可选） #

若需要每次登录都弹出Google授权提示，可确认authorizationParams的配置生效：

authorizationParams(): { [key: string]: string } {
  return {
    access_type: 'offline',
    prompt: 'consent', // 强制弹出授权弹窗，忽略已有授权会话
  };
}

测试时可使用浏览器隐私模式，避免已有Cookie影响结果。

为什么直接打开URL正常？ #

新标签页的请求是浏览器原生的GET跳转流程，完整遵循了OAuth2的设计：
浏览器发起请求 → 重定向到Google授权页 → 授权完成重定向到回调接口 → 回调接口设置Cookie并跳转到首页
这个流程能正确维护跨域会话状态，因此可以正常执行。

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