Spring Data Couchbase中count()、findAll()失效但findById()正常问题咨询

核心原因 #

该现象是Spring Data Couchbase的查询特性导致的：findById走Couchbase KV接口直接按文档键查询，不依赖索引也没有额外过滤条件；但count()、findAll()默认走N1QL查询，会自动拼接类型过滤条件，同时依赖N1QL索引，任意环节不匹配都会返回空结果。

排查步骤与解决方案 #

• 检查数据是否包含_class字段
  Spring Data Couchbase 4.x默认会对所有@Document实体插入_class字段，值为实体类的全限定类名（如com.example.demo.entity.AirlineProfile）。count和findAll生成的N1QL会自动拼接WHERE _class = "你的实体类全限定名"的过滤条件。
  如果你的Couchbase数据是手动插入、或者通过其他非Spring Data Couchbase链路写入，没有带上_class字段，就会匹配不到结果。
  解决方法二选一：
  1. 给存量数据补充_class字段，值设为AirlineProfile类的完整包路径+类名
  2. 关闭类型过滤，在配置文件中添加：

     spring.data.couchbase.type-key=
     

• 检查是否创建了对应N1QL索引
  N1QL查询依赖索引，count和findAll默认需要主索引才能执行。你可以在Couchbase查询控制台执行以下语句创建主索引：

  CREATE PRIMARY INDEX ON `你的Bucket名称`._default._default USING GSI;
  

  若你的数据存放在自定义的scope或collection下，将上面路径中的_default._default替换为实际的scope和collection名称即可。
• 检查scope/collection配置是否匹配
  如果你的数据没有存放在Couchbase默认的_default scope下的_default collection，需要在实体类的@Document注解上显式指定对应配置：

  @Document(scope = "自定义scope名", collection = "自定义collection名")
  

快速验证方法 #

你可以开启Spring Data Couchbase的SQL日志，查看实际执行的N1QL语句，复制到Couchbase查询控制台直接执行，就能快速定位是过滤条件问题还是索引问题。开启日志配置：

logging.level.org.springframework.data.couchbase.core=DEBUG

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