使用refresh token获取access token时遇invalid_grant错误求助

我们在使用refresh token获取access token时遇到error: invalid_grant错误，已知该错误通常表示refresh token无效，但已排除Google OAuth官方文档（令牌过期相关章节）中提及的常见问题。应用已上线并通过Google验证，拥有读写电子表格及发送Gmail的权限，当前为每个请求都获取access token，想确认是否存在其他导致该错误的原因。

以下是一些容易被忽略的可能原因：

• 请求频率超限：Google OAuth对refresh token的请求有频率限制。如果每次请求都触发refresh token换取access token的操作（而非复用有效期内的access token），很可能触发限流机制，返回invalid_grant。建议缓存access token至其过期（默认有效期1小时），仅在token过期后再使用refresh token刷新。
• refresh token存储/传输异常：若refresh token在存储、传输过程中被截断、篡改，或存在编码/解码错误，会直接导致token无效。检查存储的refresh token是否与授权时获取的完全一致，无任何格式错误。
• 用户账号状态变更：用户近期修改Google账号密码、变更两步验证方式，或账号被暂停/限制，即使refresh token未过期，也会被判定为无效。
• 应用OAuth配置变更：如果近期修改了应用的OAuth客户端ID/密钥，或是调整了权限范围，之前生成的所有refresh token都会失效，需要用户重新完成授权流程。
• 服务器时间同步问题：服务器系统时间与Google服务器时间偏差过大（超过5分钟），会导致令牌时间戳验证失败，返回invalid_grant。检查服务器的NTP时间同步是否正常。

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