Skip to content

错误模型

排查 SlaunchX 错误时,要分层阅读。

第一层:HTTP 状态码

  1. 401 通常表示认证缺失或无效
  2. 403 通常表示请求到了网关或策略层,但不被允许
  3. 400 通常表示请求结构或参数校验错误

第二层:公开错误码

结合响应里的 code 和 message 看具体契约失败点。

第三层:平台上下文

对于 WEB 请求,继续确认:

  1. portal 入口是否正确
  2. JWT 是否有效
  3. X-Client-Hash 是否正确
  4. 是否需要 Secure Channel

对于 API 请求,继续确认:

  1. 是否真的是 /api/v1/**
  2. endpoint 是否对 API 暴露
  3. API key 是否有对应 scope

最重要的 403 结论

403 很多时候是契约不匹配,不是接口本身坏了。

内部文档