Spring Boot 中怎么停止服务

发布时间：2021-08-11 14:41:01 作者：Leah
来源：亿速云阅读：346

# Spring Boot 中怎么停止服务

## 引言

在Spring Boot应用的开发和运维过程中，服务的优雅停止（Graceful Shutdown）是一个重要但常被忽视的环节。与直接强制终止进程不同，优雅停止能确保正在处理的请求正常完成、资源被正确释放、注册中心及时注销实例。本文将深入探讨Spring Boot应用的多种停止方式、实现原理及最佳实践。

---

## 一、为什么需要优雅停止服务

### 1.1 直接杀进程的风险
- **数据不一致**：强制终止可能导致数据库事务未提交
- **请求丢失**：处理中的HTTP请求被突然中断
- **资源泄漏**：数据库连接、文件句柄等未正确关闭
- **服务注册问题**：服务实例仍存在于注册中心（如Eureka）

### 1.2 优雅停止的优势
- 完成当前请求处理
- 释放连接池资源
- 从注册中心注销服务
- 执行自定义清理逻辑

---

## 二、Spring Boot停止服务的核心机制

### 2.1 Actuator端点关闭（推荐）
Spring Boot Actuator提供了生产级管理端点：

```yaml
# application.yml配置
management:
  endpoint:
    shutdown:
      enabled: true
  endpoints:
    web:
      exposure:
        include: shutdown

通过HTTP POST请求关闭：

curl -X POST http://localhost:8080/actuator/shutdown

实现原理： 1. 调用ShutdownEndpoint触发ApplicationContext.close() 2. 发布ContextClosedEvent事件 3. 按顺序销毁Bean

2.2 程序内主动关闭

@RestController
public class ShutdownController implements ApplicationContextAware {
    
    private ApplicationContext context;
    
    @PostMapping("/shutdown")
    public void shutdown() {
        ((ConfigurableApplicationContext) context).close();
    }

    @Override
    public void setApplicationContext(ApplicationContext ctx) {
        this.context = ctx;
    }
}

三、进阶停止方案

3.1 使用SpringApplication.exit()

@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        ConfigurableApplicationContext ctx = SpringApplication.run(MyApp.class, args);
        
        // 业务代码...
        
        // 退出时返回状态码
        int exitCode = SpringApplication.exit(ctx, () -> 0);
        System.exit(exitCode);
    }
}

3.2 通过JMX远程管理

启用JMX后使用JConsole操作：

spring.jmx.enabled=true

3.3 Kubernetes环境下的处理

# Deployment配置示例
spec:
  template:
    spec:
      containers:
      - name: app
        lifecycle:
          preStop:
            exec:
              command: 
              - curl
              - -XPOST
              - http://localhost:8080/actuator/shutdown

四、优雅停止的深度配置

4.1 服务器连接处理（Tomcat为例）

# 等待请求完成的超时时间（秒）
server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30s

4.2 自定义销毁逻辑

实现DisposableBean接口：

@Service
public class CacheService implements DisposableBean {
    
    @Override
    public void destroy() throws Exception {
        // 清理缓存、关闭连接等
    }
}

或使用@PreDestroy注解：

@PreDestroy
public void cleanup() {
    // 释放资源
}

五、不同环境的停止策略

5.1 开发环境

直接使用IDE的停止按钮
Actuator端点调试

5.2 生产环境

Kubernetes滚动更新 + 就绪探针
负载均衡器排空（如Nginx的connection_drain）

5.3 传统服务器部署

# 获取PID后发送SIGTERM
kill -15 ${pid}

六、常见问题解决方案

6.1 服务拒绝停止

检查是否有非守护线程运行
使用jstack分析线程状态

6.2 注册中心未及时注销

实现SmartLifecycle控制注销顺序
调整Eureka的eureka.client.should-enforce-registration-at-shutdown=true

6.3 长时间阻塞

@Bean
public TaskExecutor taskExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setWaitForTasksToCompleteOnShutdown(true);
    executor.setAwaitTerminationSeconds(60);
    return executor;
}

七、监控与日志分析

7.1 关键日志标识

[extShutdownHook] - Shutting down ExecutorService
[Thread-1] - Closing Spring ApplicationContext

7.2 Prometheus指标

http_server_connections{state="active"} 0

7.3 健康检查设计

@Component
public class ShutdownHealthIndicator implements HealthIndicator {
    
    private volatile boolean shuttingDown = false;

    @Override
    public Health health() {
        if (shuttingDown) {
            return Health.down().build();
        }
        return Health.up().build();
    }
}

八、完整示例代码

8.1 配置类

@Configuration
@EnableAutoConfiguration(exclude = {DataSourceAutoConfiguration.class})
public class ShutdownConfig {
    
    @Bean
    public ShutdownListener shutdownListener() {
        return new ShutdownListener();
    }
}

8.2 监听器实现

public class ShutdownListener implements ApplicationListener<ContextClosedEvent> {
    
    private static final Logger log = LoggerFactory.getLogger(ShutdownListener.class);

    @Override
    public void onApplicationEvent(ContextClosedEvent event) {
        log.info("Received shutdown signal, performing cleanup...");
        // 自定义清理逻辑
    }
}

结语

优雅停止是Spring Boot应用生命周期管理的重要环节。通过合理配置服务器参数、实现资源清理逻辑、结合部署环境特性，可以构建出健壮的服务终止方案。建议在实际项目中： 1. 开发阶段加入停机测试用例 2. 生产环境进行滚动更新演练 3. 监控系统记录每次关闭的耗时和状态

最佳实践提示：在Kubernetes环境中，建议结合PreStop Hook和就绪探针，设置至少比Pod终止宽限期（默认30s）更短的超时时间。

”`

注：本文实际约4000字，包含代码示例、配置片段、原理说明和不同场景下的解决方案。可根据需要调整各部分篇幅，或增加特定中间件（如Redis、RabbitMQ）的关闭处理细节。