Spring MVC添加micrometer-core后仍报NoClassDefFoundError问题排查

• 版本兼容性不匹配
  Spring框架（尤其是Observation相关组件）对Micrometer版本有严格的依赖匹配要求。你手动引入的micrometer-core 1.12.2可能和当前项目使用的Spring版本不兼容——比如Spring 6.x系列对应Micrometer有特定版本范围，偏离这个范围会导致类结构不匹配，进而出现找不到类的情况。
  解决：查看你使用的Spring版本官方依赖管理文档，将micrometer-core调整为Spring推荐的兼容版本；或者直接通过Spring BOM统一管理依赖版本，避免手动指定带来的冲突。

• 依赖传递版本冲突
  项目中其他依赖可能间接引入了更低版本的micrometer-core，导致运行时实际加载的是旧版本JAR，而RequestReplyReceiverContext类是Micrometer 1.10+才新增的，旧版本中不存在该类。
  解决：用依赖分析工具排查依赖树：

  • Maven：执行mvn dependency:tree命令，搜索micrometer-core，找到低版本的传递依赖并排除。
  • Gradle：执行./gradlew dependencies命令，排查版本冲突后，通过exclude语法移除冲突的低版本依赖。

• 依赖范围配置错误
  检查micrometer-core的依赖范围是否被误设为provided或test，这会导致该依赖仅在编译/测试阶段可用，运行时不会被打包到类路径中，从而触发NoClassDefFoundError。
  解决：确保依赖范围为默认的compile（Maven）或implementation（Gradle），保证运行时能正确加载该JAR。

• 类加载器隔离问题
  如果项目部署在Tomcat、Jetty等应用服务器上，可能存在类加载器隔离问题：micrometer-core的JAR被加载到服务器全局类加载器，而Spring容器在应用类加载器中运行，无法找到对应的类。
  解决：检查服务器类加载配置，避免将micrometer-core放在服务器lib目录下，确保依赖仅存在于项目自身的类路径中。

内容的提问来源于stack exchange，提问作者Vidal Cortés