# 生产检查清单
上线前按以下项目逐项确认。
## 配置
- [ ] 服务名、监听地址、超时、body limit、日志级别已配置。
- [ ] 环境差异通过配置或环境变量管理。
- [ ] 文档和配置中没有真实凭据或个人路径。
## REST/RPC 边界
- [ ] REST handler 使用统一响应和错误格式。
- [ ] RPC 服务启用 request-id metadata 或等价 trace 关联。
- [ ] public path 仅包含明确允许的健康检查和观测 endpoint。
## 可靠性
- [ ] 外部调用配置 timeout。
- [ ] 高并发入口有并发限制或上游限流。
- [ ] 不稳定依赖接入熔断或降级策略。
- [ ] 优雅停机路径已验证。
## 观测
- [ ] 关键 REST/RPC 路径有日志、metrics 或 trace。
- [ ] OTLP exporter 如启用，已配置 endpoint、resource attributes、shutdown/flush。
- [ ] metrics endpoint 不暴露敏感数据。
## 数据库与缓存
- [ ] database pool health check 已接入。
- [ ] transaction 失败路径有错误处理。
- [ ] cache key 使用稳定 namespace 和索引列顺序。
- [ ] Redis 等外部 cache 配置 timeout 和 health check。
## 注册中心与 adapter
- [ ] discovery adapter 的 service name、namespace、metadata、health 语义已确认。
- [ ] etcd/Kubernetes 等外部 adapter 有独立环境测试。
- [ ] 默认 CI 不依赖外部服务。
## 发布前验证
- [ ] `cargo metadata --format-version 1 --no-deps`
- [ ] `cargo fmt --all -- --check`
- [ ] `cargo clippy --workspace --all-targets -- -D warnings`
- [ ] `cargo test --workspace`
- [ ] 文档链接和敏感信息检查通过。
## 回滚边界
- [ ] 生成代码和手写代码分层清楚。
- [ ] 配置变更可回滚。
- [ ] 外部 adapter feature gate 和 fallback 路径已明确。