滚动更新时大文件反代日志断开，本质是反向代理与后端Pod间长连接未优雅关闭，叠加K8s终止流程中流量清理不同步；需通过就绪探针精准校验业务就绪、preStop+terminationGracePeriodSeconds协同控制终止节奏、反代层主动配合下线、SLB/Ingress层同步优化四方面解决。
滚动更新时大文件反代日志断开，本质是反向代理（如 Nginx、Envoy）与后端 Pod 之间长连接未优雅关闭，叠加 K8s 终止流程中流量清理不同步所致。重点不在“日志”本身，而在反代层对大文件传输（如下载、流式日志接口）的连接生命周期管理。以下方案直击关键环节。
确保就绪探针真正反映业务就绪状态
仅靠容器启动成功（Running）不等于能处理大文件请求。若就绪探针检查过快（例如只查端口通），新 Pod 可能被立即加入 Endpoint，但反代尚未完成 TLS 握手、缓冲区初始化或大文件读取准备，导致后续连接异常中断。
- 就绪探针路径应调用真实业务健康端点，例如 /healthz?full=true，该端点内部需验证：文件服务模块加载完成、本地缓存预热就绪、下游依赖（如对象存储 SDK）连接池可用
- initialDelaySeconds 设为 10–15 秒，periodSeconds 不低于 5 秒，避免高频探测干扰大文件传输中的 I/O 压力
- 对大文件服务类应用，可增加自定义 readiness check 脚本，检测临时目录写权限、磁盘剩余空间 ≥512MB 等硬性条件
preStop + terminationGracePeriodSeconds 必须协同生效
旧 Pod 终止时，反代可能仍在转发大文件分块请求。若 Pod 收到 SIGTERM 后立即退出，已建立的 TCP 连接会被 RST 中断，造成客户端收到 “Connection reset by peer” 或日志截断。
- 在容器内配置 preStop 执行阻塞操作：sleep 30（或调用脚本等待所有活跃 HTTP 连接数归零）
- terminationGracePeriodSeconds 必须严格大于 preStop 中的等待时间（例如设为 45 秒），否则 kubelet 会在 sleep 结束前强制发送 SIGKILL
- Spring Boot 应用需启用优雅关机：server.shutdown=graceful 且 spring.lifecycle.timeout-per-shutdown-phase=60s，确保 Tomcat/NIO 线程池等待正在传输的大文件响应完成
反代层主动配合 K8s 终止节奏
仅靠 K8s 机制不够，反向代理自身必须感知后端 Pod 即将终止，并停止向其派发新请求，同时允许存量大文件连接自然结束。
- 若使用 Nginx Ingress，启用 nginx.ingress.kubernetes.io/affinity-mode: "balanced" 避免会话粘滞导致单 Pod 承载过多长连接
- 配置 proxy_next_upstream off + proxy_next_upstream_tries 0，禁用自动重试；改由客户端控制重连逻辑（如带断点续传的下载器）
- 对日志流接口（如 /api/logs/stream），反代需设置超长超时：proxy_read_timeout 3600，并开启 proxy_buffering off 防止缓冲区截断流式响应
SLB/Ingress 层同步延迟兜底
即使 K8s Endpoint 已移除旧 Pod IP，云厂商 SLB 或 Ingress Controller 的后端同步存在秒级延迟，仍可能将新请求打到已 Terminating 的 Pod。
- 阿里云 ACK 集群建议启用 service.beta.kubernetes.io/backend-type: "eni"，使 SLB 直连 Pod IP，绕过 kube-proxy iptables 延迟
- 在 Service 上添加注解：service.beta.kubernetes.io/alibaba-cloud-loadbalancer-health-check-type: "tcp"，缩短健康检查间隔至 3 秒，加速异常 Pod 踢出
- 若使用自建 Envoy，通过 xDS 动态更新 endpoints 时，启用 drain_connections_on_host_removal: true，主动关闭待下线节点上的连接
