错误模型
排查 SlaunchX 错误时,要分层阅读。
第一层:HTTP 状态码
401通常表示认证缺失或无效403通常表示请求到了网关或策略层,但不被允许400通常表示请求结构或参数校验错误
第二层:公开错误码
结合响应里的 code 和 message 看具体契约失败点。
第三层:平台上下文
对于 WEB 请求,继续确认:
- portal 入口是否正确
- JWT 是否有效
X-Client-Hash是否正确- 是否需要 Secure Channel
对于 API 请求,继续确认:
- 是否真的是
/api/v1/** - endpoint 是否对 API 暴露
- API key 是否有对应 scope
最重要的 403 结论
403 很多时候是契约不匹配,不是接口本身坏了。