SpringBoot应用优雅关闭经验咨询：多组件场景下的问题与注意点

一、关闭应用时需额外检查的核心内容 #

• 自定义线程池的优雅终止：你用到了多个ThreadPool做异步处理，要确保每个线程池都配置了等待未完成任务结束的逻辑。比如用Spring的ThreadPoolTaskExecutor时，需设置setWaitForTasksToCompleteOnShutdown(true)和setAwaitTerminationSeconds(30)（根据任务耗时调整）；如果是手动创建的ThreadPoolExecutor，要主动调用shutdown()后再用awaitTermination()等待任务完成，同时要处理好任务拒绝策略，避免关闭阶段还有新任务提交。
• 数据库事务与连接池释放：检查是否有未提交的数据库事务，确保所有@Transactional注解的方法都执行完成，避免事务回滚导致数据不一致。另外，确认连接池（比如HikariCP）会优雅关闭所有空闲连接，并且正在使用的连接在事务完成后被正常回收。
• 消息总线的未处理消息：除了JMS嵌入式队列，还要关注消息总线的消费者状态——比如Kafka/RabbitMQ的消费者，要确保已经停止拉取新消息，并且当前正在处理的消息完成后提交偏移量，避免消息丢失或重复消费。
• 异步任务的状态追踪：对于@Async注解的异步任务，要确保Spring的异步执行器也配置了等待任务完成的逻辑，或者通过Future对象主动追踪所有未完成任务，在关闭前等待它们结束。
• 第三方服务调用的收尾：如果应用有调用外部HTTP/RMI服务，要确保正在进行的调用有合理的超时设置，避免线程因远程服务未响应而挂起。关闭时可以主动触发未完成请求的取消逻辑，或者等待超时后再继续关闭流程。
• 本地缓存的持久化：如果使用了需要持久化的本地缓存（比如Caffeine带持久化配置），要在关闭前触发缓存数据的写入操作，避免内存中的缓存数据丢失。

二、未完成HTTP/RMI调用引发异常的经验分享 #

确实遇到过这类问题，常见场景和处理方式如下：

• HTTP调用异常：关闭阶段如果有未完成的HTTP请求，可能会因为应用提前关闭连接池或容器而抛出SocketException（连接被重置），甚至导致线程挂起无法终止。解决办法：给RestTemplate或WebClient设置明确的连接超时和读取超时；在关闭时，通过线程池的awaitTermination()等待超时，或者主动取消未完成的请求。
• RMI调用异常：RMI调用如果遇到远程服务无响应，线程会一直挂起，导致应用无法正常关闭。经验是给RMI调用设置调用超时，同时注册ShutdownHook，在超时后强制中断挂起的RMI线程（但要注意中断前确保不会破坏数据一致性）；另外可以利用RMI的Lease机制，让未响应的调用自动释放资源。
• 长连接请求异常：比如WebSocket这类长连接请求，即使负载均衡器移除了实例，已建立的长连接可能还在处理中，关闭时会抛出连接关闭异常。处理方式是在关闭前主动向客户端发送连接关闭通知，或者在容器层面配置长连接的超时回收。

另外，建议通过spring.lifecycle.timeout-per-shutdown-phase配置每个关闭阶段的超时时间，避免因某个组件无法正常关闭导致应用无限挂起。

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