Spring Boot集成嵌入式MongoDB报错：找不到IFeatureAwareVersion类

这个坑我之前踩过！核心原因就是Spring Boot版本和嵌入式MongoDB（flapdoodle）的依赖版本不兼容，导致类找不到。下面是一步步解决的方案：

• 先检查你的依赖引入方式，尽量通过Spring Boot的starter来管理版本，避免手动引入冲突版本。
  如果是Maven项目，推荐这样配置：

  <!-- 核心MongoDB依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-mongodb</artifactId>
  </dependency>
  <!-- 测试依赖，注意排除可能自带的旧版flapdoodle -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
      <exclusions>
          <exclusion>
              <groupId>de.flapdoodle.embed</groupId>
              <artifactId>de.flapdoodle.embed.mongo</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  <!-- 手动引入和Spring Boot版本匹配的flapdoodle -->
  <dependency>
      <groupId>de.flapdoodle.embed</groupId>
      <artifactId>de.flapdoodle.embed.mongo</artifactId>
      <!-- 版本对应关系：Spring Boot 2.7.x用3.3.x，Spring Boot 3.x用4.x -->
      <version>3.3.2</version>
      <scope>test</scope>
  </dependency>
  

  版本对应可以查Spring Boot的官方依赖BOM，确保两者版本对齐。

• 排查依赖冲突：用Maven命令查看依赖树，找出有没有旧版的flapdoodle被间接引入：

  mvn dependency:tree | grep flapdoodle
  

  如果发现有多个版本，就在引入该依赖的地方排除掉旧版的flapdoodle。

• 检查测试类配置：确保测试类用了正确的注解，比如@SpringBootTest或者@DataMongoTest，后者会自动帮你配置嵌入式MongoDB，更适合Mongo相关的单测：

  @DataMongoTest
  class MongoRepositoryTest {
  
      @Autowired
      private UserRepository userRepository;
  
      @Test
      void testSaveUser() {
          User user = new User("test", "test@example.com");
          userRepository.save(user);
          Assertions.assertEquals(1, userRepository.count());
      }
  }
  

• 最后清理本地依赖缓存：有时候本地仓库的依赖文件损坏也会导致类找不到，删掉flapdoodle相关的目录后重新拉取：

  # Mac/Linux
  rm -rf ~/.m2/repository/de/flapdoodle/
  # Windows
  rmdir /s /q %USERPROFILE%\.m2\repository\de\flapdoodle\
  

  然后执行mvn clean install -U强制更新依赖。

按照上面的步骤来，基本就能解决找不到IFeatureAwareVersion的问题了。

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