优雅停机收尾日志需注册ShutdownHook并确保日志可靠输出：在日志初始化后注册钩子，使用同步Appender并显式刷新；Spring Boot中优先用@PreDestroy；容器中须保证Java为PID 1且terminationGracePeriodSeconds充足。
在 Java 应用中实现优雅停机时打印收尾日志，核心是捕获 JVM 关闭信号（如 kill -15 或容器正常终止），并在所有业务逻辑停止后、JVM 退出前执行清理并输出日志。关键在于：注册 JVM 关闭钩子（Runtime.addShutdownHook）+ 确保日志框架能在此时可靠输出 + 避免资源已释放导致日志丢失。
使用 ShutdownHook 记录收尾日志
这是最常用且轻量的方式。在应用启动时注册一个守护线程，在 JVM 收到终止信号后触发：
- 必须在日志系统初始化完成之后注册（否则可能因 logger 未就绪而静默失败）
- 钩子内应尽量避免耗时操作或依赖外部服务（如远程日志服务、数据库），防止阻塞 JVM 退出
- 推荐使用同步、本地日志器（如 Logback 的
ConsoleAppender或文件同步写入模式）
示例代码：
Logger logger = LoggerFactory.getLogger(MyApp.class);Runtime.getRuntime().addShutdownHook(new Thread(() -> {
logger.info("正在优雅关闭应用，开始执行收尾日志...");
logger.info("当前活跃线程数: {}", Thread.activeCount());
// 可选：调用自定义清理方法
cleanupResources();
logger.info("应用已成功完成优雅停机");
}));
确保日志框架在 shutdown 时不丢日志
很多日志框架（如 Logback、Log4j2）默认启用异步日志或缓冲写入，这会导致 shutdown hook 中的日志尚未刷出就被 JVM 强制终止。需显式刷新：
立即学习“Java免费学习笔记（深入）”；
-
Logback：调用
LoggerContext.stop()或手动触发ch.qos.logback.core.Appender#stop()，也可配置immediateFlush="true"（对 Console/FileAppender） -
Log4j2：使用
LogManager.shutdown()（推荐），它会等待异步队列清空并关闭所有 appender - 避免在 shutdown hook 中继续创建新 logger 实例（SLF4J 绑定可能已解绑）
更稳妥做法：在 shutdown hook 开头先显式关闭日志上下文（以 Logback 为例）：
LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();context.stop(); // 触发所有 appender stop 和 flushlogger.info("收尾日志已强制刷盘");
结合 Spring Boot 的优雅停机支持
Spring Boot 2.3+ 原生支持优雅停机（需配置 server.shutdown=graceful），它会在收到信号后：
- 拒绝新请求，等待现存请求完成（可设超时
spring.lifecycle.timeout-per-shutdown-phase） - 按顺序关闭 Spring 容器内 Bean（含
@PreDestroy方法） - 最后才触发 JVM shutdown hook
因此建议将收尾日志放在：
- 一个
@Bean(destroyMethod = "shutdown")的组件里，或 - 实现
DisposableBean接口的类中，或 - 带
@PreDestroy注解的方法里（确保该 Bean 是单例且被 Spring 管理）
这样既能利用 Spring 生命周期控制，又能保证在 Web 容器关闭后、JVM 退出前记录日志。
注意容器环境下的信号传递
在 Docker/K8s 中，kill -15 默认发给 PID 1 进程。若你的 Java 进程不是 PID 1（比如用了 shell 启动：ENTRYPOINT ["sh", "-c", "java ..."]），则信号无法到达 JVM —— 导致 shutdown hook 不触发。
- 解决方案：使用 exec 格式启动，如
ENTRYPOINT ["java", "-jar", "app.jar"] - 或在 shell 启动脚本末尾加
exec "$@"，把控制权交还给 JVM - K8s 中确认
terminationGracePeriodSeconds足够长（默认 30s），避免 SIGKILL（-9）过早介入
