Spring Boot 2.2.6升级至2.7.11时Prometheus相关配置报错

问题根源 #

你遇到的NoSuchMethodError是依赖版本不兼容导致的：

• Spring Boot 2.7.x版本内置了特定版本的Micrometer（1.9.x系列），而你手动指定了micrometer-registry-prometheus:1.11.0，这个高版本的PrometheusMeterRegistry构造方法签名和Spring Boot 2.7.x自动配置期望的不匹配。
• 同时手动指定的simpleclient:0.16.0、collector:0.18.0也和Micrometer 1.9.x的适配版本不一致，进一步加剧了依赖冲突。

解决步骤 #

1. 移除手动指定的依赖版本，依赖Spring Boot的版本管理 #

Spring Boot的spring-boot-dependencies会自动管理所有配套组件的版本，你只需要保留依赖坐标，去掉版本号：

compile("org.springframework.boot:spring-boot-starter-actuator")

// 移除手动指定的版本，由Spring Boot自动适配
implementation group: 'io.prometheus', name: 'simpleclient'
implementation group: 'io.prometheus.jmx', name: 'collector'
implementation group: 'io.micrometer', name: 'micrometer-registry-prometheus'

更简洁的方式是直接使用Spring Boot提供的Prometheus starter，它会自动引入所有必要的依赖：

compile("org.springframework.boot:spring-boot-starter-actuator")
compile("org.springframework.boot:spring-boot-starter-prometheus")
implementation group: 'io.prometheus.jmx', name: 'collector'

2. 检查并解决依赖冲突 #

执行以下命令查看依赖树，确认所有Micrometer、Prometheus相关依赖的版本一致：

• Gradle：

  ./gradlew dependencies
  

• Maven：

  mvn dependency:tree
  

重点关注micrometer-core、micrometer-registry-prometheus、simpleclient的版本，确保它们是Spring Boot 2.7.11对应的版本（Micrometer 1.9.x）。

3. 清理构建缓存并重新构建 #

清理本地构建缓存，确保拉取正确的依赖版本：

• Gradle：

  ./gradlew clean build --refresh-dependencies
  

• Maven：

  mvn clean install -U
  

注意事项 #

Spring Boot的自动配置体系高度依赖组件版本的兼容性，避免手动指定starter之外的组件版本，尽量通过Spring Boot的依赖管理来控制版本，减少此类兼容性问题。

内容的提问来源于stack exchange，提问作者jatin mahajan