Spring应用在Kubernetes中PreDestroy方法未执行完容器即被销毁问题排查

以下是几个常见的错误点和对应的解决办法：

1. Kubernetes终止宽限期设置过短 #

Kubernetes默认的terminationGracePeriodSeconds是30秒，如果你的@PreDestroy清理操作耗时超过这个时间，K8s会直接强制杀死容器，不管清理有没有完成。

• 解决：在Deployment的Pod模板里调大这个值，比如设置为60秒（根据实际清理时长调整）：

  spec:
    terminationGracePeriodSeconds: 60
  

2. Java进程没收到SIGTERM信号 #

K8s发送SIGTERM信号触发优雅停机，但如果容器的PID1是shell脚本而非Java进程，信号会被shell拦截，无法传递给Spring应用，导致@PreDestroy根本没被触发就直接被强制终止。

• 解决：
  • 启动命令用exec前缀，让Java进程成为PID1：exec java -jar your-app.jar
  • 如果用启动脚本，添加信号转发逻辑：

    # 捕获TERM/INT信号并转发给Java进程
    trap 'kill -TERM $PID' TERM INT
    java -jar your-app.jar &
    PID=$!
    wait $PID
    

3. @PreDestroy注解使用不正确 #

确保你的清理方法满足以下条件：

• 方法所在的类是Spring管理的Bean（加了@Component、@Service等注解）
• 使用的是正确的@PreDestroy注解：javax.annotation.PreDestroy 或 org.springframework.stereotype.PreDestroy
• 如果方法里有异步操作，要手动等待异步任务完成，否则Spring上下文会提前关闭，导致清理不彻底。比如用CountDownLatch或者Future.get()等待异步任务结束。

4. 健康探针配置不合理 #

Kubernetes在发送SIGTERM后，仍会继续检查存活探针。如果存活探针在清理过程中返回失败，K8s会提前终止容器。同时，就绪探针应该在停机开始时就返回失败，避免新流量进入。

• 解决：
  • 调整就绪探针：在应用开始关闭时，让就绪探针端点返回非200状态码，比如新增/actuator/shutdown端点（需开启actuator），触发关闭后修改就绪探针逻辑。
  • 调整存活探针的failureThreshold和periodSeconds，给清理操作足够缓冲时间，比如设置periodSeconds: 10，failureThreshold: 6，最多等待60秒才判定存活失败。

5. Spring Boot版本过低或配置缺失 #

Spring Boot 2.3+才对优雅停机做了完善支持，旧版本可能存在信号处理问题。另外需确保开启优雅停机配置：

• 解决：在application.properties或application.yml中添加：

  server.shutdown=graceful
  spring.lifecycle.timeout-per-shutdown-phase=60s
  

  spring.lifecycle.timeout-per-shutdown-phase设置每个关闭阶段的超时时间，要小于等于K8s的terminationGracePeriodSeconds。

内容的提问来源于stack exchange，提问作者user1474111