Spring Boot应用停止失败：JMX bean not found问题及跨服务停止方案咨询

一、解决mvn spring-boot:stop报错问题 #

报错核心原因是spring-boot:stop依赖JMX（Java Management Extensions）识别并控制Spring Boot应用的生命周期Bean，但你的应用启动时未正确配置JMX参数，或未以fork模式启动，导致Maven无法定位到org.springframework.boot:type=Admin,name=SpringApplication这个JMX Bean。

修复步骤： #

1. 修改pom.xml中的Spring Boot Maven插件配置，开启fork并指定JMX端口：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.4.2</version>
            <configuration>
                <!-- 必须开启fork，让应用在独立进程运行，Maven才能通过JMX连接 -->
                <fork>true</fork>
                <!-- 指定固定JMX端口，避免端口冲突或自动端口无法识别 -->
                <jmxPort>9001</jmxPort>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 重新启动配置服务：执行mvn spring-boot:run，此时应用会以fork模式启动并暴露指定的JMX端口。
3. 执行停止命令：再次运行你的bash脚本，mvn spring-boot:stop就能正常找到JMX Bean并优雅停止服务。

二、从其他Spring Boot微服务优雅停止配置服务 #

推荐使用Spring Boot Actuator的shutdown端点实现跨服务优雅停止，步骤如下：

1. 配置服务中开启Actuator Shutdown端点 #

• 添加Actuator依赖：在配置服务的pom.xml中加入：

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

• 配置端点暴露与启用：在配置服务的application.yml（或application.properties）中添加：

management:
  endpoints:
    web:
      exposure:
        include: shutdown # 暴露shutdown端点到Web
  endpoint:
    shutdown:
      enabled: true # 启用shutdown功能

注意：生产环境必须为该端点添加安全防护，比如通过Spring Security配置Basic认证或OAuth2授权，防止未授权访问。

2. 调用方微服务中实现停止逻辑 #

在需要触发停止的微服务中，使用RestTemplate或WebClient调用配置服务的shutdown端点：

示例代码（RestTemplate实现）：

import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class ConfigServiceShutdownService {
    private final RestTemplate restTemplate;

    // 构造注入RestTemplate
    public ConfigServiceShutdownService(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    public void triggerConfigServiceShutdown() {
        // 替换为你的配置服务实际地址和端口
        String shutdownUrl = "http://config-service:8888/actuator/shutdown";
        
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        // 如果配置了安全认证，添加授权头，比如Basic Auth：
        // headers.setBasicAuth("username", "password");
        
        HttpEntity<String> requestEntity = new HttpEntity<>("", headers);
        // 发送POST请求触发停止
        restTemplate.postForObject(shutdownUrl, requestEntity, String.class);
    }
}

其他可选方案 #

• JMX远程调用：通过JMX连接到配置服务的JMX端口，调用生命周期Bean的stop()方法，但实现复杂度较高，适合对JMX有经验的场景。
• 服务注册中心联动：如果使用Spring Cloud，可结合Eureka等注册中心，通过服务发现定位配置服务后再调用shutdown端点，适配动态服务地址场景。

内容的提问来源于stack exchange，提问作者Frado Bhalla