Spring Kotlin调用Couchbase自定义查询返回空Dao对象问题排查

成因分析 #

你的自定义N1QL查询返回的JSON结构存在嵌套问题，导致Spring Data Couchbase无法正确映射到Dao对象的属性：

• 执行SELECT Meta().id AS __id, * FROM \bucket``时，Couchbase会将文档内容嵌套在一个以bucket名称为键的顶层对象中，返回的JSON结构类似：

  {
    "__id": "document-id-123",
    "bucket": {
      "_class": "com.....CurrencyDominationDao",
      "lastUpdated": 1690000000,
      "storeId": "store-001",
      "otherField": "value"
    }
  }
  

• Spring Data Couchbase的对象映射器默认期望Dao类的属性与顶层JSON字段一一对应，因此无法识别嵌套在bucket键下的内容，最终只有__id（Spring Data默认识别的文档ID字段）能被正确映射，其余字段因无法匹配而使用默认值。

而Couchbase在线查询界面会直接展示嵌套内容，所以你看起来数据正常，但Spring端的映射逻辑不处理这种嵌套结构。

解决方案 #

修改N1QL查询语句，将文档内容提取为顶层字段，避免嵌套：

写法1：使用表别名（推荐） #

通过给bucket设置别名，直接选择别名下的所有字段，确保返回的JSON字段平级：

SELECT Meta(b).id AS __id, b.*
FROM `bucket` b
WHERE b._class = "com.....CurrencyDominationDao"
AND b.lastUpdated >= $1 AND b.storeId = $2

写法2：直接指定bucket的所有字段 #

如果不想用别名，也可以直接选择bucket下的所有字段作为顶层输出：

SELECT Meta().id AS __id, `bucket`.*
FROM `bucket`
WHERE _class = "com.....CurrencyDominationDao"
AND lastUpdated >= $1 AND storeId = $2

修改后，查询返回的JSON结构会变成平级形式，Spring Data Couchbase就能正常将字段映射到Dao对象的对应属性上：

{
  "__id": "document-id-123",
  "_class": "com.....CurrencyDominationDao",
  "lastUpdated": 1690000000,
  "storeId": "store-001",
  "otherField": "value"
}

额外验证点 #

1. 确认Dao类的字段名称与Couchbase文档中的字段名称完全匹配（注意大小写敏感，若有自定义映射需检查@Field注解）
2. 确保仓库接口的查询方法参数绑定正确，响应式Flow的返回类型配置无误（如Flow<CurrencyDominationDao>）

内容的提问来源于stack exchange，提问作者Saher Al-Sous