升级Spring 5到6运行单元测试时遇NoClassDefFoundError：缺失MetaAnnotationUtils

这个错误是因为org.springframework.test.util.MetaAnnotationUtils在Spring Framework 6中已被移除，虽然你的代码没直接引用，但大概率是传递依赖的第三方库或者项目自定义测试组件在间接使用这个类。以下是具体解决步骤：

• 检查依赖树定位冲突源
  用依赖分析工具找出哪个库还在依赖Spring Test 5.x或引用该类：

  • Maven执行：mvn dependency:tree | grep -i spring-test
  • Gradle执行：./gradlew dependencies | grep -i spring-test
    重点排查是否有低版本的spring-test被其他依赖间接引入，或者第三方测试类库（比如旧版本的测试框架、自定义starter）还依赖这个类。

• 排除冲突的传递依赖
  如果发现某个第三方库引入了Spring Test 5.x，在依赖声明中排除它：
  Maven示例：

  <dependency>
      <groupId>第三方库groupId</groupId>
      <artifactId>第三方库artifactId</artifactId>
      <version>版本号</version>
      <exclusions>
          <exclusion>
              <groupId>org.springframework</groupId>
              <artifactId>spring-test</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

  Gradle示例：

  implementation("第三方库groupId:第三方库artifactId:版本号") {
      exclude group: 'org.springframework', module: 'spring-test'
  }
  

• 检查并更新自定义测试代码
  项目中如果有自定义的测试扩展（比如TestExecutionListener子类、注解处理器、测试工具类），可能间接用到了MetaAnnotationUtils。Spring 6中该类的功能已被拆分到以下类中，需要替换：

  • 注解元数据解析：改用org.springframework.core.annotation.AnnotationUtils
  • 测试上下文相关的注解处理：改用org.springframework.test.context.support.AnnotationConfigContextLoaderUtils或org.springframework.test.context.TestContextAnnotationUtils

• 统一Spring Boot依赖版本
  确保项目依赖Spring Boot的parent或dependencyManagement，不要手动指定spring-test的版本——Spring Boot 3.0.4会自动管理所有Spring 6.x系列依赖的版本，避免版本不一致问题。比如移除pom.xml中手动指定的spring-test版本号，让Spring Boot统一管控。

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