Spring Boot报错：需配置io.micrometer.core.instrument.MeterRegistry Bean

排查思路和解决办法 #

1. 核对版本兼容性 #

micrometer-core和spring-boot-starter-actuator的版本必须和你的Spring Boot版本匹配：Spring Boot 2.x对应micrometer 2.x系列，Spring Boot 3.x对应micrometer 3.x系列。查看依赖树截图，确认是否存在不同版本的micrometer-core导致冲突。

2. 确认自动配置未被禁用 #

Spring Boot的MetricsAutoConfiguration自动配置类会自动生成MeterRegistry的bean。检查启动类或配置类上是否有@SpringBootApplication(exclude = {MetricsAutoConfiguration.class})这类排除配置，有的话直接删除。

3. 规范自定义MeterRegistry配置（若有） #

如果自己编写了MeterRegistry的配置类，必须用@Bean注解将实例正确注册到Spring容器，示例代码：

import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.simple.SimpleMeterRegistry;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MetricsConfig {
    @Bean
    public MeterRegistry meterRegistry() {
        return new SimpleMeterRegistry();
    }
}

若无特殊需求，不要自定义该配置，让Spring自动配置生效即可。

4. 补全对应监控组件依赖 #

如果要对接Prometheus，需额外引入micrometer的Prometheus registry依赖：

• Maven依赖：

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

• Gradle依赖：

implementation 'io.micrometer:micrometer-registry-prometheus'

该依赖会自动配置对应的MeterRegistry bean，避免缺失问题。

5. 完善配置文件细节 #

在你的application.yml中添加Prometheus导出开启配置，确保功能正常：

management:
  endpoints:
    web:
      exposure:
        include: info, health, loggers, prometheus
  metrics:
    web:
      server:
        request:
          autotime:
            percentiles: 0.50,0.75,0.95,0.99
  metrics.export.prometheus.enabled: true

6. 清理缓存重新构建 #

执行mvn clean install（Maven项目）或gradle clean build（Gradle项目）清理构建缓存，同时重启IDE重新加载项目，排除缓存导致的依赖加载异常。

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