Spring Boot集成测试报Unsatisfied依赖错误的排查与解决

核心问题定位 #

迁移到Windows后集成测试抛出Unsatisfied dependency expressed through constructor parameter 0，但主应用正常运行，主要原因集中在类名/文件名大小写不匹配和嵌入式MongoDB的Windows兼容性两个方面。

1. 类名拼写不一致（关键原因） #

查看代码发现：

• 服务类实际定义为LifeinsService（类名中ins为小写）
• 控制器AllInsController中注入的类型为LifeInsService（Ins为大写）

MacOS默认文件系统大小写不敏感，编译运行时会忽略这种差异；但Windows下Java严格区分类名大小写，导致Spring无法找到对应类型的Bean，直接触发依赖注入失败。

2. 嵌入式MongoDB的Windows兼容性问题 #

使用的de.flapdoodle.embed.mongo在Windows环境下需要额外配置或依赖：

• 缺少Visual C++运行库，导致嵌入式Mongo无法启动
• 默认存储路径包含Windows不支持的字符或权限不足
• 端口被占用或版本不兼容

解决办法 #

步骤1：修正类名与注入类型的一致性 #

• 将服务类LifeinsService重命名为LifeInsService，确保类名与控制器中注入的类型完全一致
• 同步修改对应的文件名LifeinsService.java为LifeInsService.java，保证Java类名与文件名严格匹配

步骤2：修复嵌入式MongoDB的Windows适配 #

1. 安装Visual C++运行库：
   下载并安装微软官方提供的Visual C++ Redistributable运行库，嵌入式MongoDB依赖该库才能在Windows上运行。

2. 配置嵌入式Mongo的存储路径与端口：
   在application-test.properties中添加以下配置：

   # 指定MongoDB连接地址
   spring.data.mongodb.uri=mongodb://localhost:27017/test-integration-db
   # 设置嵌入式Mongo的存储目录（Windows兼容路径）
   de.flapdoodle.mongodb.embedded.storage.dir=C:/temp/embedded-mongo-data
   # 自动选择可用端口，避免端口占用
   de.flapdoodle.mongodb.embedded.port=0
   

3. 升级Flapdoodle依赖版本：
   确保依赖版本与Spring Boot 3.1.5兼容，可尝试将de.flapdoodle.embed.mongo.spring30x版本升级到最新稳定版（如4.10.0），更新pom.xml：

   <dependency>
       <groupId>de.flapdoodle.embed</groupId>
       <artifactId>de.flapdoodle.embed.mongo.spring30x</artifactId>
       <version>4.10.0</version>
       <scope>test</scope>
   </dependency>
   

步骤3：清理编译缓存并重新构建 #

执行Maven命令清理旧编译文件，重新下载依赖并构建：

mvn clean install -DskipTests

之后再运行集成测试，验证问题是否解决。

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