失败、重试与审计关联
处理认证、权限、冲突和底层失败,不把受理当成功。
HTTP 失败与异步任务失败分开处理。请求返回 2xx 后仍需跟踪任务;查询成功也不表示客户机内部服务已经可用。
| 状态 | 建议处理 |
|---|---|
| 400 | 校验参数,修正后提交,不原样自动重试 |
| 401 | 登录失效或认证方式不支持,停止授权操作并重新认证 |
| 403 | 权限、租户或 CSRF/Origin 不满足,按错误上下文处理 |
| 404 | 资源不存在或不可见,不据此推断跨租户资源详情 |
| 409 | 状态、依赖或幂等冲突,先查询当前资源和任务 |
| 429 | 降低调用频率,遵循响应提供的限制信息 |
| 503 | 依赖或服务未就绪,保留业务身份并检查原任务 |
保存 request_id、任务 UUID 与资源 UUID,便于平台审计关联。避免记录请求中的密码、私钥、会话 Cookie、控制台票据或渠道 Webhook。
对网络超时先确认是否已受理,同一业务动作使用同一幂等键。扩容、重装、恢复等出现部分成功时,依靠原任务重试和确认状态,不在第三方系统中直接删除数据库记录或磁盘文件。
