SpringBoot 2集成Micrometer指标运行报错求助

你遇到的问题是Micrometer采集HikariCP连接池指标时获取不到有效值，导致发送NaN到InfluxDB被拒绝。我来帮你梳理几个核心原因和对应的解决办法：

1. 开启HikariCP的MBean注册 #

Micrometer是通过JMX采集HikariCP指标的，如果HikariCP没注册MBean，Micrometer就拿不到任何数据，自然会生成NaN。你只需要在配置文件里添加一行配置：

如果是application.properties：

spring.datasource.hikari.register-mbeans=true

如果是application.yml：

spring:
  datasource:
    hikari:
      register-mbeans: true

添加后重启应用，先检查Actuator的/actuator/metrics/hikaricp.connections端点，如果这里能看到正常数值，说明采集环节的问题已经解决。

2. 检查版本兼容性 #

SpringBoot 2早期版本和Micrometer、HikariCP的组合可能存在兼容性问题，导致指标采集失败。确保你的依赖版本匹配：

• SpringBoot 2.0.x 对应 Micrometer 1.0.x
• SpringBoot 2.1.x 对应 Micrometer 1.1.x
• 尽量使用SpringBoot依赖管理中的默认HikariCP版本，避免手动指定不兼容的版本。

如果用Maven，可以查看pom.xml中micrometer-registry-influx的版本是否和spring-boot-starter-actuator传递过来的Micrometer版本一致。

3. 过滤NaN指标（适配老版本InfluxDB） #

如果你的InfluxDB版本较老，不支持接收NaN值，可以自定义InfluxMeterRegistry来过滤这些无效值：

import io.micrometer.core.instrument.Clock;
import io.micrometer.core.instrument.MetricFamilySamples;
import io.micrometer.influx.InfluxConfig;
import io.micrometer.influx.InfluxMeterRegistry;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.ArrayList;
import java.util.List;

@Configuration
public class InfluxCustomConfig {

    @Bean
    public InfluxMeterRegistry influxMeterRegistry(InfluxConfig config) {
        return new InfluxMeterRegistry(config, Clock.SYSTEM) {
            @Override
            protected void publish(Iterable<MetricFamilySamples> samples) {
                // 过滤掉所有值为NaN的指标样本
                Iterable<MetricFamilySamples> filteredSamples = filterNaNMetrics(samples);
                super.publish(filteredSamples);
            }

            private Iterable<MetricFamilySamples> filterNaNMetrics(Iterable<MetricFamilySamples> original) {
                List<MetricFamilySamples> validFamilies = new ArrayList<>();
                for (MetricFamilySamples family : original) {
                    List<MetricFamilySamples.Sample> validSamples = new ArrayList<>();
                    for (MetricFamilySamples.Sample sample : family.samples) {
                        if (!sample.value.isNaN()) {
                            validSamples.add(sample);
                        }
                    }
                    if (!validSamples.isEmpty()) {
                        validFamilies.add(new MetricFamilySamples(
                                family.name, family.type, family.help, validSamples
                        ));
                    }
                }
                return validFamilies;
            }
        };
    }
}

这个配置会在发送指标到InfluxDB前自动剔除NaN样本，避免出现解析错误。

4. 验证连接池是否正常初始化 #

如果以上步骤都没解决问题，先确认HikariCP连接池是否真的正常工作：

• 查看应用启动日志，有没有数据库连接失败的报错
• 尝试在代码中获取数据库连接，验证是否能正常操作数据库
• 如果连接池根本没初始化，自然不会有指标数据，会显示NaN

按这个顺序排查，应该能解决你遇到的NaN指标问题。

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