如何排查Spring Boot整合MongoDB时的UnsatisfiedDependencyException错误？

核心原因 #

你遇到的UnsatisfiedDependencyException根因是MongoDB数据库名称未配置，Spring Boot无法初始化MongoDB相关Bean，进而导致依赖注入失败。

具体排查与修复步骤 #

• 补全MongoDB配置文件
  在application.properties或application.yml中明确指定数据库名称，两种配置方式二选一即可：

  • 拆分配置（application.properties）：

    spring.data.mongodb.host=localhost
    spring.data.mongodb.port=27017
    spring.data.mongodb.database=你的数据库名（比如item_db）
    

  • URI配置（application.properties）：

    spring.data.mongodb.uri=mongodb://localhost:27017/你的数据库名
    

  若MongoDB需要账号密码，URI格式为mongodb://用户名:密码@localhost:27017/你的数据库名?authSource=admin

• 验证依赖正确性
  检查pom.xml中是否引入了正确的MongoDB starter依赖，避免版本冲突：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-mongodb</artifactId>
  </dependency>
  

  不要同时引入spring-data-mongodb和spring-boot-starter-data-mongodb，后者已包含前者的内容。

• 检查Repository与实体类注解

  • 实体类添加@Document注解指定集合（规范操作）：

    @Document(collection = "item_details")
    public class ItemDetails {
        // 字段与注解
    }
    

  • Repository接口正确继承MongoRepository：

    public interface ItemDetailsRepository extends MongoRepository<ItemDetails, String> {
        // 自定义查询方法
    }
    

• 确认启动类扫描范围
  @SpringBootApplication默认扫描自身所在包及子包，确保Repository、控制器、实体类都在启动类的包层级下，示例结构：

  com.example.springbootdemo
  ├── SpringBootDemoApplication.java（启动类）
  ├── entity
  │   └── ItemDetails.java
  ├── repository
  │   └── ItemDetailsRepository.java
  └── controller
      └── ItemsAPIService.java
  

总结 #

优先补全配置文件中的数据库名称，这是最直接的解决点。重启应用后若仍有问题，再依次排查依赖、注解和扫描范围。

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