Spring Boot Micrometer忽略management.metrics.export.statsd.host配置

核心问题是Micrometer StatsD注册表未正确读取management.metrics.export.statsd.host配置，始终 fallback 到默认的localhost:8125，即便配置值已通过端点确认正确。

1. 对齐Spring Boot与Micrometer版本兼容性 #

Micrometer 1.13.x对应Spring Boot 3.2.x版本，版本不匹配会导致自动配置的属性绑定失效：

• 若用Spring Boot 3.1.x，需搭配Micrometer 1.12.x
• 若用Spring Boot 3.2.x，才能使用Micrometer 1.13.x

建议检查项目依赖版本，确保二者版本匹配。

2. 排查手动创建StatsdMeterRegistry的代码 #

如果代码中手动定义了StatsdMeterRegistry的@Bean，且未使用Spring Boot提供的StatsdProperties初始化，会覆盖自动配置，导致配置文件的host/port不生效。比如以下错误写法会默认使用localhost：

@Bean
public StatsdMeterRegistry statsdMeterRegistry() {
    return StatsdMeterRegistry.builder(new StatsdConfig() {
        @Override
        public String get(String key) { return null; }
    }).build();
}

正确做法是注入StatsdProperties，让配置文件参数生效：

@Configuration
public class StatsdConfiguration {
    @Bean
    public StatsdMeterRegistry statsdMeterRegistry(StatsdProperties properties) {
        StatsdConfig config = new StatsdConfig() {
            @Override
            public String get(String key) { return null; }

            @Override
            public String host() { return properties.getHost(); }

            @Override
            public int port() { return properties.getPort(); }

            @Override
            public boolean enabled() { return properties.isEnabled(); }
        };
        return StatsdMeterRegistry.builder(config).build();
    }
}

3. 检查生产环境的环境变量覆盖 #

生产环境中，环境变量优先级高于application.properties配置。如果存在SPRING_MANAGEMENT_METRICS_EXPORT_STATSD_HOST或STATSD_HOST这类环境变量，会覆盖配置文件中的设置。可通过查看生产环境的环境变量列表确认是否有此类覆盖。

4. 验证自动配置是否加载 #

启动应用时，查看日志中是否有StatsdMetricsExportAutoConfiguration相关的加载日志。如果未出现，说明依赖缺失或自动配置被禁用，需检查依赖引入是否完整，是否有自定义配置禁用了自动装配。

可以在代码中注入StatsdProperties并打印值，确认配置是否被正确加载：

@RestController
public class ConfigController {
    private final StatsdProperties statsdProperties;

    public ConfigController(StatsdProperties statsdProperties) {
        this.statsdProperties = statsdProperties;
    }

    @GetMapping("/statsd-config")
    public Map<String, Object> getStatsdConfig() {
        return Map.of(
            "host", statsdProperties.getHost(),
            "port", statsdProperties.getPort(),
            "enabled", statsdProperties.isEnabled()
        );
    }
}

如果接口返回的配置正确，但Metrics仍发送到localhost，说明问题出在StatsdMeterRegistry的初始化逻辑，而非配置读取环节。

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