ReactiveCosmosRepository自定义查询方法失效问题咨询

我来帮你拆解下这个问题——你基于ReactiveCosmosRepository创建的仓储，自带的findById、save能正常跑，但自定义的findByColumnName(String name)这类方法执行失败还没抛出异常，核心问题大概率是依赖版本冲突，还有一些细节需要注意，具体如下：

核心原因：新旧SDK依赖冲突 #

你同时引入了两套完全不兼容的Cosmos DB Spring Data依赖：

• azure-cosmosdb-spring-boot-starter:2.3.3 和 azure-cosmosdb:2.6.11 属于旧版SDK体系（命名空间com.microsoft.azure），这套是基于Cosmos DB v2 SDK开发的
• azure-spring-data-cosmos:3.0.0-beta.2 属于新版SDK体系（命名空间com.azure），是基于Cosmos DB v3 SDK重构的

这两套依赖的底层实现、注解规范、Repository解析逻辑完全不兼容，同时引入会导致Spring容器无法正确识别自定义查询方法的处理规则，最终出现方法执行无响应但无异常的情况。

其他可能的原因 #

• 自定义方法缺少必要注解
  新版azure-spring-data-cosmos对自定义查询的支持需要配合@Query注解明确指定SQL语句，不像JPA那样能完全自动解析方法名生成查询。如果没加注解，框架没法解析你的查询逻辑，会静默失败。
• 实体类字段映射注解不匹配
  旧版SDK常用@JsonProperty或@Field做字段映射，新版则用@CosmosProperty，如果注解用错，框架无法关联实体字段和容器中的属性，也会导致查询无结果且无异常。
• 旧版SDK对方法名解析支持有限
  旧版的Spring Data Cosmos实现对findByXXX这类方法名的自动解析支持并不完善，很多场景下必须手动通过@Query指定SQL才能生效。

快速解决建议 #

1. 统一依赖体系
   要么彻底使用旧版：删掉azure-spring-data-cosmos依赖，只保留azure-cosmosdb-spring-boot-starter和对应的azure-cosmosdb；要么升级到新版稳定版（避免用beta版，比如azure-spring-data-cosmos:3.20.0），同时移除所有旧版com.microsoft.azure下的Cosmos依赖。
2. 给自定义方法添加正确注解
   如果用新版SDK，给自定义查询方法加上@Query注解，示例：

   @Query("SELECT * FROM c WHERE c.columnName = @name")
   Mono<YourEntity> findByColumnName(@Param("name") String name);
   

3. 检查分区键配置
   如果你的Cosmos容器设置了分区键，自定义查询要么在SQL中包含分区键条件，要么在方法参数上添加@PartitionKey注解，否则框架可能因无法定位分区而静默失败。

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