调用Gmail API的users.messages.get时出现重定向的原因及解决方法

问题描述 #

调用Gmail API获取邮件时，Go客户端因跟随重定向次数达到上限报错：

Get "https://www.google.com/sorry/index?continue=https://gmail.googleapis.com/gmail/v1/users/me/messages/186fcaba0de2c103%3Falt%3Djson%26format%3Dmetadata%26prettyPrint%3Dfalse&q=EhQ0WJdTGNi_5J4ZIjDuikp4BXiPLIs8CUe1LwNSe7C1o4C4rcYk2_W7gKUxVgXMh-MXORDYLkM4PRRenpjyAmRy": stopped after 10 redirects

疑惑点：通过users.history.list获取的邮件ID，调用users.messages.get时为何出现循环重定向甚至超过10次？该现象意味着什么？有哪些解决办法？

原因分析 #

1. Google安全机制触发：重定向到google.com/sorry是Google人机验证/安全检查启动的典型表现。可能是请求频率过高、IP被标记为异常、账号有可疑操作，或是API调用上下文被判定为风险请求。由于Go客户端自动跟随重定向，但程序无法完成人机验证，导致进入循环重定向直至次数上限。
2. 权限或邮件特殊情况：部分邮件涉及敏感内容，或是你的OAuth2令牌权限不足（比如缺少gmail.readonly或gmail.metadata权限），导致请求被拦截后陷入重定向循环。
3. Go客户端默认限制：Go标准库http.Client默认允许最多10次重定向，循环重定向会快速触达这个限制并报错。

解决办法 #

• 完成安全验证：复制报错中continue参数后的完整URL，用浏览器打开并完成Google的人机验证（如验证码、账号确认）。验证完成后，程序后续的API调用会在一段时间内恢复正常。
• 控制请求频率：严格遵守Gmail API的配额限制，批量获取邮件时添加合理的请求间隔，避免触发Google的安全拦截机制。
• 自定义重定向逻辑：修改Go客户端的重定向策略，遇到google.com/sorry页面时停止跟随，避免循环。示例代码：

  import (
      "net/http"
      "strings"
  )
  
  func createCustomClient() *http.Client {
      return &http.Client{
          CheckRedirect: func(req *http.Request, via []*http.Request) error {
              if strings.Contains(req.URL.String(), "google.com/sorry") {
                  return http.ErrUseLastResponse
              }
              if len(via) >= 5 {
                  return http.ErrTooManyRedirects
              }
              return nil
          },
      }
  }
  

• 检查权限与参数：确认OAuth2令牌已申请gmail.readonly或gmail.metadata权限；核对users.messages.get的调用参数，确保format=metadata等参数符合API要求。
• 排查IP与账号状态：如果是服务器IP被标记，可尝试更换IP；检查Google账号是否有异常登录记录，确保账号处于安全状态。

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