SpringBoot集成MongoDB报错：无法解析mongoTemplate bean引用

• 依赖合法性校验
  确保pom.xml中引入了Spring Boot官方的MongoDB starter依赖，避免依赖冲突：

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

  不要同时引入独立的mongo-java-driver等可能与starter冲突的依赖。

• Atlas配置正确性检查
  核对application.properties中的MongoDB连接URI格式是否准确：

  spring.data.mongodb.uri=mongodb+srv://<用户名>:<密码>@<集群地址>/<数据库名>?retryWrites=true&w=majority
  

  替换占位符后，注意密码中的特殊字符需做URL编码（如@替换为%40），同时确认Atlas控制台已允许当前IP访问集群。

• 启动类注解与扫描范围确认
  启动类需标注@SpringBootApplication，若仓库、服务等组件不在启动类的包或子包下，需补充指定扫描范围：

  @SpringBootApplication
  @EnableMongoRepositories(basePackages = "com.your.package.repository")
  @ComponentScan(basePackages = "com.your.package")
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

• 仓库层代码规范检查
  确保ItemRepository正确继承Spring Data MongoDB的仓库接口：

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

  无需手动创建mongoTemplate实例，Spring Boot会根据配置自动生成该bean。

• 自定义MongoTemplate的冲突排查
  若手动配置了MongoTemplate bean，需确保bean名称为mongoTemplate且依赖注入正常：

  @Bean
  public MongoTemplate mongoTemplate(MongoDatabaseFactory mongoDbFactory) {
      return new MongoTemplate(mongoDbFactory);
  }
  

  避免重复定义或依赖缺失导致bean初始化失败。

• 实体类注解校验
  实体类GroceryItem需标注@Document指定集合，主键字段标注@Id：

  @Document(collection = "grocery_items")
  public class GroceryItem {
      @Id
      private String id;
      private String name;
      // Getter、Setter方法
  }
  

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