Spring项目从Java 8迁移至Java 11：用Micrometer替代Dropwizard Metrics实现端点状态与响应指标采集及@Counted注解失效问题排查

当然可以实现和Dropwizard Metrics一致的指标格式！我来一步步帮你解决问题——先搞定@Counted注解不生效的坑，再调整Micrometer的配置，让它输出你需要的指标命名。

一、为什么@Counted注解没生效？ #

你遇到的@Counted无效，大概率是因为缺少AOP依赖或者没开启切面支持：

• 首先确保你的项目引入了Spring AOP依赖：

  <!-- Maven -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-aop</artifactId>
  </dependency>
  

  // Gradle
  implementation 'org.springframework.boot:spring-boot-starter-aop'
  

• 然后在你的配置类上加上@EnableAspectJAutoProxy注解，开启切面支持（引入依赖后Spring Boot通常会自动配置，但显式声明更稳妥）。

不过其实对于Web端点来说，Spring Boot + Micrometer已经默认会自动采集请求计数和响应时间（就是你配置里的management.metrics.web.server.auto-time-requests=true），所以其实不用手动加@Counted，我们直接基于默认的Web指标调整格式就行，更省心。

二、自定义指标命名，匹配Dropwizard格式 #

Dropwizard是把状态码、URI路径直接拼进指标名称里，而Micrometer默认是用http.server.requests作为主指标名，再通过status、uri等标签区分。要转换成你需要的格式，我们可以通过自定义MeterFilter + StatsD导出配置来实现：

1. 配置StatsD的标签处理 #

因为你用的是Etsy风格的StatsD，它支持把标签转换成指标名称的后缀。在你的配置文件里加上这一行：

management.metrics.export.statsd.tags-as-dimensions=true

2. 自定义MeterFilter重命名指标 #

创建一个配置类，写个MeterFilter来把默认的Web指标重命名成Dropwizard的格式：

import io.micrometer.core.instrument.Meter;
import io.micrometer.core.instrument.config.MeterFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.regex.Matcher;
import java.util.regex.Pattern;

@Configuration
public class MetricsConfig {

    // 匹配/my_service/后面的路径部分，比如v1/api/some/endpoint
    private static final Pattern URI_PATTERN = Pattern.compile("^/my_service/(v\\d+/.+)$");

    @Bean
    public MeterFilter dropwizardStyleNamingFilter() {
        return new MeterFilter() {
            @Override
            public Meter.Id map(Meter.Id id) {
                // 只处理Web请求的指标
                if ("http.server.requests".equals(id.getName())) {
                    String status = id.getTag("status");
                    String uri = id.getTag("uri");

                    if (status != null && uri != null) {
                        // 提取URI中去掉/my_service的部分，把斜杠换成点
                        Matcher matcher = URI_PATTERN.matcher(uri);
                        String pathPart = matcher.find() ? matcher.group(1).replace("/", ".") : uri.replace("/", ".");

                        // 根据指标类型生成对应名称
                        switch (id.getType()) {
                            // 计数器：metrics.prefix.counter.status.200.v1.api.some.endpoint
                            case COUNTER:
                                return id.withName(String.format("counter.status.%s.%s", status, pathPart));
                            // 响应时间：metrics.prefix.gauge.response.v1.api.some.endpoint
                            case TIMER:
                                return id.withName(String.format("gauge.response.%s", pathPart));
                            default:
                                return id;
                        }
                    }
                }
                return id;
            }
        };
    }
}

这个配置会把默认的http.server.requests指标，按照计数器/响应时间（Timer）分别重命名，同时处理URI路径，去掉/my_service前缀并把斜杠换成点，完全匹配你原来的Dropwizard格式。

3. 利用已有的前缀配置 #

你已经在配置里设置了management.metrics.export.statsd.prefix=metrics.prefix，StatsD会自动把这个前缀加到所有指标名称前面，最终生成的指标就和你之前用Dropwizard时的完全一样了！

三、验证效果 #

启动应用后，访问localhost:8080/my_service/v1/api/some/endpoint，去你的StatsD服务器上看接收的指标，应该就能看到：

• 计数器指标：metrics.prefix.counter.status.200.v1.api.some.endpoint
• 响应时间指标：metrics.prefix.gauge.response.v1.api.some.endpoint

另外，Micrometer的Timer默认会输出多个统计值（比如总和、计数、百分位数），如果你只想保留类似Dropwizard的单一响应时间数值，可以再加个MeterFilter过滤：

@Bean
public MeterFilter timerStatisticFilter() {
    // 只保留Timer的VALUE统计值，模拟Dropwizard的gauge效果
    return MeterFilter.deny(id -> id.getName().startsWith("gauge.response.") && !id.getTag("statistic").equals("VALUE"));
}

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