发布验证与故障排查

发布完成标准

每次部署至少验证：

1. BuildJob 最终成功。
2. deployment 引用的是预期 artifactId。
3. Artifact 的项目和工作区归属正确。
4. 环境配置与 Provider 绑定能够解析。
5. deployment 进入最终运行状态。
6. 稳定 Endpoint 已生成。
7. 健康检查通过。
8. 携带正确身份的真实业务请求成功。
9. 无 token、错误 token 和越权用户请求被拒绝。
10. 日志能够通过请求标识关联到本次调用，且不包含密钥。

构建成功但没有 Artifact

确认 BuildJob 是否真正进入成功终态，并使用 Artifact 查询命令读取产物。不要从日志中的文件路径推导 artifactId。

部署提示 Artifact 不合法

检查 Artifact 是否：

• 属于当前工作区和项目
• 状态可部署
• 类型、URI、校验值、大小和入口信息完整
• 没有被误写成 buildJobId

部署长时间未完成

查询 deployment 的最新状态和公开错误消息，再检查配置解析、容器启动、端口和健康检查。不要因为控制面已经接受请求就认定服务已经上线。

Endpoint 返回未授权

依次检查：

1. 目标环境的鉴权模式。
2. consumer 是否属于该环境。
3. token 是否有效、未撤销并发给了正确调用方。
4. 请求是否使用服务要求的认证头。
5. 业务应用自身是否还有第二层用户鉴权。

回滚

环境配置错误时，修复配置后可以重新部署同一个 Artifact。程序内容错误时，选择此前已经验证的 Artifact 重新部署，或修复源码后构建新 Artifact。

回滚也必须等待 deployment 进入最终状态并执行健康、鉴权和业务验证，不能只看部署请求返回成功。