eBay API 授权码无效或过期错误排查指南

eBay API 授权失败排查：invalid_grant 错误解析

在对接 eBay Open API 进行支付或订单同步时，偶尔会收到如下响应：

{
  "error": "invalid_grant",
  "error_description": "the provided authorization grant code is invalid or was issued to another client"
}

这个报错非常典型，直接指向 OAuth 2.0 授权流程中的凭证失效问题。

核心原因

大多数情况下，这是因为授权码（Authorization Code）已过期。eBay 发放的临时授权码有效期极短，日志中常伴随 expires_in=299 这样的时间戳提示。这意味着从用户同意授权到服务器换取 Access Token 之间，如果耗时超过了几分钟，该代码就会作废。

此外，如果代码被重复使用（例如用于不同 Client ID 的请求），也会触发'发给其他客户端'的警告。

解决方案

1. 检查时效性：确保获取授权码后立即请求 Access Token，不要缓存过期的 Code。
2. 验证 Client ID：确认当前请求使用的 Client ID 与申请授权码时的完全一致。
3. 重新授权：如果 Token 已彻底失效，需要引导用户重新走一遍 OAuth 授权跳转流程，获取新的 Code。

这类问题在自动化脚本或定时任务中尤为常见，建议增加重试机制或监控 Token 的剩余有效期。