CodeBuddy中实现优雅停机需配置Spring Boot内置支持、SmartLifecycle钩子、Actuator端点、WebFlux取消传播及调度器协同关闭，确保请求、事务、消息处理完整后再终止。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy开发应用程序时希望实现优雅停机（Graceful Shutdown），确保服务关闭前完成所有正在处理的HTTP请求、数据库事务或消息消费，避免请求中断或数据丢失，则需主动配置生命周期钩子与资源等待机制。以下是多种可落地的实现方法：
一、利用Spring Boot内置的Graceful Shutdown支持
Spring Boot 2.3+ 版本原生支持优雅停机，通过配置启用后，应用接收到关闭信号（如SIGTERM）时会暂停接收新请求，并等待现存请求完成后再终止JVM。
1、在application.yml中添加以下配置：
server.shutdown=graceful
2、设置最大等待时间（例如60秒），防止无限期挂起：
spring.lifecycle.timeout-per-shutdown-phase=60s
3、确保Web服务器为Tomcat（默认）、Jetty或Undertow——三者均被Spring Boot自动适配以支持该特性。
二、手动注册Shutdown Hook并协调资源关闭顺序
当需要更细粒度控制停机流程（如先停止消息监听器、再等待HTTP请求完成、最后关闭数据库连接池），可通过Spring的SmartLifecycle接口或JVM Shutdown Hook显式管理各组件生命周期。
1、创建一个实现SmartLifecycle的Bean，设置isAutoStartup()为true且getPhase()返回较高数值（如2147483647），确保其最后启动、最先停止：
@Component public class GracefulShutdownManager implements SmartLifecycle
2、在stop()方法中执行以下动作：
1、调用Web服务器的shutdown()方法（如TomcatServletWebServerFactory获取到的Connector.stop()）；
2、向自定义请求计数器发送停止信号，禁止新请求进入业务逻辑层；
3、循环检查当前活跃请求数是否降为0，每次间隔100ms，总超时设为60秒；
4、调用dataSource.getConnection().close()等资源清理逻辑（若未使用连接池自动管理）。
三、结合Actuator端点触发可控停机流程
通过Spring Boot Actuator暴露/actuator/shutdown端点，允许外部系统（如Kubernetes preStop hook）主动发起受控关闭，替代依赖操作系统信号，提升确定性。
1、在pom.xml中引入actuator依赖（若尚未添加）：
org.springframework.boot:spring-boot-starter-actuator
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、在application.yml中启用shutdown端点并保护其访问：
management.endpoints.web.exposure.include=health,info,shutdown
management.endpoint.shutdown.enabled=true
3、部署时在Kubernetes中配置preStop生命周期钩子，调用该端点：
lifecycle: preStop: exec: command: ["curl", "-X", "POST", "http://localhost:8080/actuator/shutdown"]
四、使用Reactor或WebFlux时适配响应式优雅停机
对于基于Project Reactor构建的响应式应用（如Spring WebFlux），需确保Mono/Flux链式操作具备取消传播能力，并在停机阶段主动触发CancellationException以中断未完成流。
1、在WebFlux配置类中注入WebServerFactoryCustomizer，设置Netty或Tomcat的等待超时：
((NettyReactiveWebServerFactory) factory).setShutdownTimeout(Duration.ofSeconds(60));
2、对关键业务HandlerFunction添加timeout()和onErrorResume()兜底逻辑，捕获CancelledException并记录日志：
Mono.fromCallable(() -> processRequest()).timeout(Duration.ofSeconds(30)).onErrorResume(CancellationException.class, e -> Mono.empty());
3、在全局Filter中监听ServerWebExchange是否处于关闭状态，拒绝新请求：
if (webServer.getShutdownStatus() == WebServer.State.STOPPING) { return Mono.error(new IllegalStateException("Server is shutting down")); }
五、集成分布式任务调度器的协同停机策略
当应用内嵌Quartz、XXL-JOB或ShardingSphere ElasticJob等调度组件时，需确保定时任务不被强制中断导致状态不一致，应提前通知调度中心释放分片并等待本地执行器完成当前作业。
1、在Spring容器关闭前，调用调度器的standby()或shutdown(true)方法（如QuartzScheduler.shutdown(true)）：
scheduler.shutdown(true); // 等待当前Job执行完毕
2、若使用XXL-JOB执行器，重写destroy()方法，在其中调用XxlJobExecutor.destroy()，该方法内部已包含线程池优雅关闭与回调通知逻辑；
3、对长周期批处理任务（如文件解析、报表生成），在任务主逻辑中定期检查Thread.currentThread().isInterrupted()，主动退出循环并保存断点：
if (Thread.interrupted()) { saveCheckpoint(); return; }
