Spring Boot 3 优雅停机配置与实战

@RestController
@RequestMapping("/api")
public class DemoController {
    @GetMapping("/long-running")
    public String longRunningTask() throws InterruptedException {
        System.out.println("开始执行耗时任务...");
        Thread.sleep(20000); // 模拟耗时任务
        return "任务完成";
    }
}

为了便于测试，可以在启动类中添加销毁钩子：

@PreDestroy
public void destroy() {
    System.out.println("Application is destroyed");
}

本地调试与测试

直接在 IDE 点击停止按钮往往无法模拟真实的停机信号，因此推荐使用 Actuator 端点进行测试。添加依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

配置暴露端点：

management:
  endpoints:
    web:
      exposure:
        include: '*'
  endpoint:
    shutdown:
      enabled: true

调用 curl -X POST http://localhost:8080/actuator/shutdown 即可触发停机流程。如果请求在宽限期内，会返回'任务完成'；若超过宽限期，请求将被强制中止。

负载均衡器中的停机策略

在生产环境中，仅靠应用层配置还不够。建议配合负载均衡器（如 Nginx、Kubernetes）使用。当服务准备停机时，先从负载均衡池中剔除该实例，确保新流量不再转发到该节点，随后再发送关闭信号。这样能确保所有请求被其他实例接管，当前实例只处理已有请求直至完成。

优雅停机的注意事项

• 宽限期配置：需根据业务最长请求时间合理设置，避免因过短导致任务中断。
• 负载均衡器协作：务必确认负载均衡器的健康检查与摘除机制已生效。
• 避免频繁重启：高负载下频繁停机会影响用户体验，应规划好维护窗口。

总结

Spring Boot 3 通过简单的配置即可实现优雅停机，有效减少服务关闭对用户体验的影响。Tomcat 和 Reactor Netty 均采用在网络层阻止新请求、应用层设置宽限期的方式。在高并发微服务架构中，结合负载均衡策略正确配置优雅停机，是保持系统稳定性和一致性的必要手段。