Spring Boot Kafka报java.lang.NoSuchFieldError: UNTYPED错误求助

问题根源 #

这个java.lang.NoSuchFieldError: UNTYPED错误是Micrometer与Prometheus客户端依赖版本不兼容导致的：io.prometheus:simpleclient_common的某个版本移除/重命名了UNTYPED字段，但项目中io.micrometer:micrometer-registry-prometheus模块仍依赖该字段的存在，两者版本不匹配触发错误。该问题与Kafka Client版本无关，更换Kafka版本无法解决问题。

具体解决步骤 #

1. 排查依赖冲突 #

先定位项目中引入的不兼容依赖版本：

• Maven项目执行命令：

  mvn dependency:tree | grep -E "(micrometer|simpleclient)"
  

• Gradle项目执行命令：

  ./gradlew dependencies | grep -E "(micrometer|simpleclient)"
  

查看输出中micrometer-core、micrometer-registry-prometheus和simpleclient_common的版本是否对齐。

2. 统一依赖版本 #

方案1：利用Spring Boot依赖管理（推荐）

如果使用Spring Boot，直接借助其内置的依赖管理机制，确保所有Micrometer和Prometheus相关依赖版本自动对齐：

• Maven：确保pom.xml中引入Spring Boot父依赖，无需手动指定版本：

  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>你的Spring Boot版本（如2.6.13或2.7.10）</version>
      <relativePath/>
  </parent>
  
  <dependencies>
      <!-- 引入Spring Kafka和Prometheus监控依赖 -->
      <dependency>
          <groupId>org.springframework.kafka</groupId>
          <artifactId>spring-kafka</artifactId>
      </dependency>
      <dependency>
          <groupId>io.micrometer</groupId>
          <artifactId>micrometer-registry-prometheus</artifactId>
      </dependency>
  </dependencies>
  

• Gradle：同样使用Spring Boot插件，依赖版本自动管理：

  plugins {
      id 'org.springframework.boot' version '你的Spring Boot版本'
      id 'io.spring.dependency-management' version '1.0.15.RELEASE'
      id 'java'
  }
  
  dependencies {
      implementation 'org.springframework.kafka:spring-kafka'
      implementation 'io.micrometer:micrometer-registry-prometheus'
  }
  

方案2：手动强制指定兼容版本

若无法使用Spring Boot依赖管理，需手动指定匹配的版本组合（参考官方兼容矩阵）：

• Micrometer 1.8.x → Prometheus Simpleclient 0.15.x
• Micrometer 1.9.x → Prometheus Simpleclient 0.16.x
• Micrometer 1.10.x → Prometheus Simpleclient 0.17.x

以Maven为例，强制指定版本并排除冲突依赖：

<dependencyManagement>
    <dependencies>
        <!-- 强制指定Simpleclient版本 -->
        <dependency>
            <groupId>io.prometheus</groupId>
            <artifactId>simpleclient_common</artifactId>
            <version>0.15.0</version>
        </dependency>
        <!-- 强制指定Micrometer版本 -->
        <dependency>
            <groupId>io.micrometer</groupId>
            <artifactId>micrometer-core</artifactId>
            <version>1.8.10</version>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- 排除Spring Kafka可能引入的旧版Micrometer -->
    <dependency>
        <groupId>org.springframework.kafka</groupId>
        <artifactId>spring-kafka</artifactId>
        <exclusions>
            <exclusion>
                <groupId>io.micrometer</groupId>
                <artifactId>micrometer-core</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

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

执行完依赖调整后，清理本地仓库缓存避免旧依赖干扰：

• Maven：删除~/.m2/repository/io/prometheus和~/.m2/repository/io/micrometer目录，然后执行mvn clean install
• Gradle：执行./gradlew clean build --refresh-dependencies

4. 验证修复 #

重启Spring Boot应用，再次调用REST接口发送Kafka消息，确认500错误是否消失。

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