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.
相关产品推荐
相关产品推荐

