Spring Boot中CosmosRepository Bean找不到及重复注册问题排查

初始错误：找不到PersonRepository类型的Bean #

原因 #

Spring Boot默认不会自动识别并生成CosmosRepository的实现Bean，必须显式开启Cosmos仓库的扫描机制，否则Spring无法将你的PersonRepository接口实例化为可注入的Bean。

添加@EnableCosmosRepositories后的新错误（中文翻译） #

无法注册bean 'personRepository'：该bean已在CosmosDbRepositoriesAutoConfigureRegistrar.EnableCosmosDbRepositoriesConfiguration通过@EnableCosmosRepositories定义，同时在PersonApplication类的@EnableCosmosRepositories中也定义了同名bean，且Bean覆盖功能已禁用。

新错误原因 #

从azure-spring-data-cosmos 3.x版本开始，框架已经通过自动配置类默认开启了@EnableCosmosRepositories，手动在启动类添加该注解会导致重复扫描同一个Repository接口，生成两个同名Bean，触发冲突。

最终解决方案 #

1. 移除启动类上的@EnableCosmosRepositories注解
   依赖框架的自动配置即可，无需手动添加该注解。

2. （可选）指定仓库扫描路径（如果Repository不在启动类子包下）
   如果你的PersonRepository所在包不是启动类PersonApplication的子包，可通过配置文件指定扫描路径，避免手动加注解：

   # application.properties
   spring.data.cosmos.repositories.base-packages=com.example
   

3. 确认实体类的Cosmos注解配置
   确保Person实体类正确添加了Cosmos所需的注解，示例：

   import com.azure.spring.data.cosmos.core.mapping.Container;
   import com.azure.spring.data.cosmos.core.mapping.PartitionKey;
   import org.springframework.data.annotation.Id;
   
   @Container(containerName = "person") // 指定Cosmos容器名
   public class Person {
       @Id // 主键字段
       private String id;
       
       @PartitionKey // 分区键字段（根据业务需求设置）
       private String partitionKey;
       
       // 其他字段、Getter/Setter方法
   }
   

4. 完善Cosmos配置信息
   在application.properties或application.yml中添加Cosmos DB的连接配置：

   # application.properties
   spring.data.cosmos.uri=你的Cosmos DB实例URI
   spring.data.cosmos.key=你的Cosmos DB访问密钥
   spring.data.cosmos.database=你的数据库名称
   

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