fix: harden health probe responses

2026-09-20 20:35:34 +08:00
parent 8aef89f179
commit 9e87249ca4
3 changed files with 18 additions and 0 deletions
--- a/docs/api/health.md
+++ b/docs/api/health.md
@@ -36,6 +36,8 @@ curl -i http://127.0.0.1:8080/health/ready
 {"status":"not_ready"}
 ```

+健康检查响应带 `Cache-Control: no-store` 和 `X-Content-Type-Options: nosniff`，避免探针状态被缓存。`503` 会带 `Retry-After: 1`，提示路由层至少等待 1 秒后再探测；实际探测周期仍由部署平台配置决定。
+
 响应不包含 DSN、数据库错误文本或凭据。检查迁移记录不能发现所有人工 DDL 漂移，运行账户权限和迁移流程仍需受控。

 进程收到 `SIGTERM` 后会先进入排空状态：就绪探针立即返回 `503`，再在有限的优雅关闭窗口内停止 HTTP/WS 服务并等待存量请求结束。存量任务租约不会因为探针变化而被删除，仍由正常恢复逻辑接管。