优雅下线

现象或背景 我们一条 24 节点（16C64G，Kubernetes 1.28.9 + containerd 1.7.13，cgroup v2）的核心交易集群，Java 17 + Spring Boot 3.1，Pod 副本数 12，QPS

«作者：江墨白-195｜15 年技术团队负责人｜分布式一致性与消息中间件方向 栈：Kafka 3.5.1（KRaft，3 broker，8C32G）、Spring Kafka 3.1.5、Java 17（G1）、K8s 1.28、消费组 2

«结论先行："preStop" 里写一个 "sleep 5" 并不是"优雅下线"，它只是在赌 kube-proxy / iptables 规则的下发速度。 下面是一次真实的滚动更新事故复盘，以及我们最终落地的完整优雅下线方案。» 一、现象与

«结论先行：滚动发布期间那波「每次都来、但每次又只持续几十秒」的 5xx，根因几乎都是优雅下线的时序没配对，而不是代码 bug。这篇文章给一份我能直接抄的 preStop + terminationGracePeriodSeconds 配置

【背景】 我负责一个 3 节点 K8s 1.28 集群（containerd 1.7，CNI 是 Calico 路由模式），跑 Spring Boot 3 / Java 17 的无状态订单服务，入口是集群内 Service + 一个 Env