You need to enable JavaScript to run this app. Rails纯API应用用Devise+Doorkeeper实现Google/Facebook社交登录排查
优惠活动
大模型
产品
解决方案
定价
更多

Rails纯API应用用Devise+Doorkeeper实现Google/Facebook社交登录排查

纯API模式Rails应用接入Google/Facebook OAuth2兑换自有JWT卡点排查

前置实现基础

  • 基于Devise + Doorkeeper完成登录流程搭建,配套实现了JWT令牌管理体系
  • 移动端(Android、iOS)已可在客户端侧完成Google、Facebook的OAuth授权流程,成功获取第三方返回的用户访问令牌
  • 参考doorkeeper-grants-assertion示例开发,核心目标为将第三方返回的用户访问令牌兑换为应用自有JWT令牌
  • 目前Facebook全链路已跑通,可正常完成用户查找/创建、自有令牌生成全流程,仅Google链路持续报错

Google链路现有代码实现

class GoogleController

  def initialize(auth_code)
    @auth_code = auth_code
    @user_data = user_data
  end

  def user_data
    url = "https://www.googleapis.com/oauth2/v3/userinfo?access_token=" + @auth_code
    response = Faraday.get(url, {:Accept => 'application/json'})
    @resp = JSON.parse(response.body)
  end

  def email
    @resp['email']
  end

  def first_name
    @resp['first_name']
  end

  def last_name
    @resp['last_name']
  end

  def get_user!
    # 基于拉取到的第三方用户数据查找/创建应用内用户,返回用户对象
    user = User.find_by(email: email)
    if user
      Rails.logger.info "User"
      user
    else
      user = User.new(email: email, password: Devise.friendly_token.first(10))
      user.save
      Rails.logger.info "No User"
      user
    end
  end
end

初期接口调试报错

使用Postman调用令牌兑换接口时,请求体配置如下:

{
  "client_id": "doorkeeper_app_uid",
  "client_secret": "doorkeeper_app_secret",
  "grant_type": "assertion",
  "provider": "google",
  "assertion": "MY USER TOKEN"
}

对应返回错误:

{
  "error": "invalid_client",
  "error_description": "Client authentication failed due to unknown client, no client authentication included, or unsupported authentication method."
}

前期Facebook链路调试时,曾定位到根因是接口逻辑未正确返回User对象,修正后采用相同代码逻辑,仅针对不同第三方提供方调整令牌校验端点,Facebook链路即可正常完成用户查找/创建、自有JWT生成全流程。

深入排查后的核心阻塞点

经多轮调试确认:

  • Google链路已可正常调用Google用户信息接口完成数据拉取,也可在应用侧正常定位到/创建对应用户
  • 但将用户对象返回给Doorkeeper assertion grant扩展时,始终触发PasswordAccessTokenRequest类的资源所有者校验逻辑拦截,无法生成应用侧JWT
  • 触发失败的校验代码逻辑为:
def validate_resource_owner
  !resource_owner.nil?
end

Google与Facebook链路的差异原因排查方向

  • 静默返回值异常:对比FacebookController的异常捕获逻辑,检查GoogleController拉取用户数据时,是否因第三方接口请求失败、返回结构异常,导致email方法返回nil,最终get_user!返回nil。Facebook链路通常会在拉取失败时直接抛出错误中断流程,不会出现静默返回nil的情况;而GoogleController未做异常捕获时,一旦接口返回非预期结构,就会静默走到返回nil的分支,直接触发resource_owner为空的校验失败。
  • 用户创建校验失败:检查Google链路新建用户时的user.save结果,当前实现仅给User对象赋值了邮箱和随机密码,未将拉取到的姓、名字段赋值到用户模型。若User模型配置了姓、名等字段的非空校验,save操作会静默失败,虽然最终返回了user对象,但该对象未满足Doorkeeper对resource_owner的有效持久化对象要求,同样会触发校验失败。
  • 路由映射配置异常:检查Doorkeeper assertion grant的provider映射配置,确认provider: "google"是否正确绑定到GoogleController的解析逻辑。若映射配置漏写、类名不匹配,系统将不会调用GoogleController的get_user!方法,而是默认走PasswordAccessTokenRequest流程,因找不到对应资源所有者触发校验失败。
  • 客户端凭据匹配问题:对照Facebook链路调试时的客户端配置,确认Google链路请求传入的client_id、client_secret是否与Doorkeeper侧注册的、用于第三方令牌兑换的客户端配置完全匹配。若凭据不匹配,会直接触发invalid_client错误,流程根本不会进入用户校验环节。

内容的提问来源于stack exchange,提问作者Vi.

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.12 00:36:03