LOCAL PLATFORM TOOL平台运营诊断器
按平台和错误码查询排查步骤与解决动作。
InvalidInput · 请求输入无效validation
请求参数、字段格式或组合不符合接口要求。
排查顺序
- 对照当前 API 版本逐项核对请求字段。
- 使用最小请求重现并检查字段级错误路径。
解决动作
- 修正参数后重新提交请求。
- 移除不支持字段并使用当前版本允许的值。
重试策略：按官方状态确认Unauthorized · SP-API 身份验证失败authentication
访问令牌、签名或授权上下文无法验证。
排查顺序
- 核对凭证签发时间、应用、环境和目标账号。
- 检查授权响应、令牌 Scope 与服务器时间。
解决动作
- 刷新有效令牌或重新完成官方授权流程。
- 修正应用标识、签名参数和回调地址后再请求。
重试策略：按官方状态确认InvalidToken · LWA 访问令牌无效authentication
LWA Access Token 无效、过期或不适用于当前请求。
排查顺序
- 核对凭证签发时间、应用、环境和目标账号。
- 检查授权响应、令牌 Scope 与服务器时间。
解决动作
- 刷新有效令牌或重新完成官方授权流程。
- 修正应用标识、签名参数和回调地址后再请求。
重试策略：按官方状态确认AccessDenied · SP-API 访问被拒绝permission
应用角色、卖家授权或受限数据令牌不满足要求。
排查顺序
- 对照官方文档确认接口所需权限。
- 核对用户角色、资产归属和授权状态。
解决动作
- 在最小权限原则下补充必要授权。
- 改用有权访问目标资源的账号或令牌。
重试策略：按官方状态确认QuotaExceeded · 接口配额已用尽rate-limit
请求配额或突发容量已耗尽。
排查顺序
- 读取响应头、配额信息和 Retry-After。
- 按应用、账号和端点统计请求速率。
解决动作
- 使用指数退避和随机抖动重试。
- 降低并发、合并请求并缓存可复用结果。
重试策略：退避后重试Throttling · 请求被限流rate-limit
调用频率超过接口恢复速率或突发上限。
排查顺序
- 读取响应头、配额信息和 Retry-After。
- 按应用、账号和端点统计请求速率。
解决动作
- 使用指数退避和随机抖动重试。
- 降低并发、合并请求并缓存可复用结果。
重试策略：退避后重试ResourceNotFound · Amazon 资源不存在resource
订单、商品、报告或其他目标资源不存在。
排查顺序
- 确认资源真实存在且属于当前账号和区域。
- 使用列表接口重新获取资源 ID 和状态。
解决动作
- 改用有效资源标识或先创建、启用资源。
- 修复资源归属或授权后再执行操作。
重试策略：按官方状态确认Conflict · 资源状态冲突commerce
当前资源状态与请求操作发生冲突。
排查顺序
- 读取资源当前状态和关联关系。
- 核对库存地点、商品变体、订单阶段与数量。
解决动作
- 先修复业务资源状态或关联关系。
- 按平台要求拆分或调整业务操作。
重试策略：按官方状态确认ServerError · Amazon 服务端错误server
SP-API 处理请求时发生临时内部异常。
排查顺序
- 查看平台状态页并记录请求 ID 和发生时间。
- 用不含敏感数据的最小请求确认问题是否持续。
解决动作
- 使用有限次数的指数退避重试。
- 持续失败时携带请求 ID 联系官方支持。
重试策略：退避后重试ServiceUnavailable · SP-API 服务暂不可用server
接口维护、过载或依赖服务异常。
排查顺序
- 查看平台状态页并记录请求 ID 和发生时间。
- 用不含敏感数据的最小请求确认问题是否持续。
解决动作
- 使用有限次数的指数退避重试。
- 持续失败时携带请求 ID 联系官方支持。
重试策略：退避后重试RequestExpired · 签名请求已过期authentication
请求时间戳与 Amazon 服务时间偏差过大。
排查顺序
- 核对凭证签发时间、应用、环境和目标账号。
- 检查授权响应、令牌 Scope 与服务器时间。
解决动作
- 刷新有效令牌或重新完成官方授权流程。
- 修正应用标识、签名参数和回调地址后再请求。
重试策略：按官方状态确认InvalidSignature · AWS 请求签名不匹配authentication
Canonical Request、区域、服务名或签名密钥错误。
排查顺序
- 核对凭证签发时间、应用、环境和目标账号。
- 检查授权响应、令牌 Scope 与服务器时间。
解决动作
- 刷新有效令牌或重新完成官方授权流程。
- 修正应用标识、签名参数和回调地址后再请求。
重试策略：按官方状态确认规则版本：platform-errors-2026.09 · 结果需要结合平台原始请求和账号状态人工核验
