使用google-drive-ruby获取Refresh Token及凭证持久化问题

我之前也碰到过一模一样的问题，其实核心原因是OAuth2授权请求的参数没配置对，导致Google没有返回refresh_token。下面给你一步步拆解解决方案：

为什么refresh_token会是nil？ #

Google的OAuth2规则里，只有满足两个条件才会返回refresh_token：

1. 授权请求中明确指定了access_type=offline，告诉Google你需要支持离线访问（后续不用用户重新登录就能刷新token）；
2. 要么是用户第一次授权，要么授权请求中加了prompt=consent参数，强制用户重新确认授权（否则后续重复授权不会返回新的refresh_token）。

如果你的授权流程没加这两个参数，调用credentials.fetch_access_token!后自然拿不到refresh_token。

如何获取有效的refresh_token？ #

修改你的授权URL生成代码，确保加上这两个关键参数：

# 初始化授权客户端
client = Google::APIClient.new
auth = client.authorization

# 配置你的客户端信息（从Google Cloud Console获取）
auth.client_id = '你的Client ID'
auth.client_secret = '你的Client Secret'
auth.scope = 'https://www.googleapis.com/auth/drive' # 根据需求调整权限范围
auth.redirect_uri = 'urn:ietf:wg:oauth:2.0:oob' # 本地测试用这个，线上换成你的回调URL

# 关键配置：必须加这两行！
auth.access_type = 'offline'       # 要求返回refresh_token
auth.prompt = 'consent'            # 强制用户重新授权，确保每次都返回refresh_token

# 生成授权URL，让用户访问这个URL获取authorization_code
puts "请访问以下URL授权：#{auth.authorization_uri.to_s}"

用这个新生成的URL让用户授权，拿到authorization_code后再执行：

credentials.code = authorization_code
credentials.fetch_access_token!

# 现在credentials.refresh_token就有值了！
puts "Refresh Token: #{credentials.refresh_token}"

怎么把凭证保存到数据库以便后续复用？ #

你需要把凭证的关键字段存储起来，后续可以通过这些字段重建授权会话。这里以Rails的ActiveRecord为例：

1. 创建凭证模型 #

首先生成存储凭证的模型和迁移：

rails generate model OAuthCredential access_token:string refresh_token:string expires_at:datetime client_id:string client_secret:string scope:string redirect_uri:string user:references
rails db:migrate

2. 保存凭证到数据库 #

拿到有效的credentials后，把字段映射保存：

# 假设当前用户是current_user
saved_cred = OAuthCredential.find_or_initialize_by(user: current_user)

# 映射credentials的字段到模型
saved_cred.access_token = credentials.access_token
saved_cred.refresh_token = credentials.refresh_token
saved_cred.expires_at = Time.at(credentials.expires_at) # 转成datetime类型
saved_cred.client_id = credentials.client_id
saved_cred.client_secret = credentials.client_secret
saved_cred.scope = credentials.scope.join(' ') # scope是数组，转成字符串存储
saved_cred.redirect_uri = credentials.redirect_uri

# 保存（注意：敏感字段建议加密存储！）
saved_cred.save!

3. 从数据库恢复会话 #

后续需要使用Google Drive服务时，从数据库取出凭证重建授权：

# 取出当前用户的存储凭证
saved_cred = OAuthCredential.find_by(user: current_user)

# 重建credentials对象
credentials = Google::APIClient::ClientSecrets.new(
  {
    "web" => {
      "client_id" => saved_cred.client_id,
      "client_secret" => saved_cred.client_secret,
      "redirect_uri" => saved_cred.redirect_uri,
      "scope" => saved_cred.scope
    }
  }
).to_authorization

# 填充存储的token信息
credentials.access_token = saved_cred.access_token
credentials.refresh_token = saved_cred.refresh_token
credentials.expires_at = saved_cred.expires_at.to_i

# 如果access_token过期了，自动刷新并更新数据库
if credentials.expired?
  credentials.refresh_access_token!
  saved_cred.update!(
    access_token: credentials.access_token,
    expires_at: Time.at(credentials.expires_at)
  )
end

# 最后创建Google Drive会话
session = GoogleDrive::Session.from_credentials(credentials)

重要注意事项 #

• 一定要保存好refresh_token：Google只会在第一次授权（或强制consent）时返回，丢失后只能让用户重新授权；
• 加密敏感字段：client_secret、refresh_token、access_token都是敏感信息，不要明文存储，建议使用Rails的encrypted_attributes或第三方加密库处理；
• 检查Google Cloud Console配置：确保你的客户端ID/Secret、redirect_uri、权限范围都和代码里的配置一致。

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