使用Couchbase Java SDK子文档Upsert后MutateInResult索引无效求助

核心原因 #

默认情况下，mutateIn操作不会返回修改后的内容，只有显式指定返回子文档内容时，才能通过contentAs获取结果。你执行的是单个upsert子文档操作，但未配置返回选项，导致结果集中没有任何元素，调用索引0自然会触发“Index 0 is invalid”错误。

解决方案 #

在构建MutateInOptions时，通过两种方式配置返回逻辑，确保SDK返回修改后的内容：

方式1：针对单个子文档操作返回值 #

为upsert操作添加returnValue(true)，仅返回当前修改的子文档内容：

MutateInResult result = collection.mutateIn(
    "目标文档ID",
    Arrays.asList(MutateInSpec.upsert("目标JSON路径", "新值").returnValue(true)),
    MutateInOptions.mutateInOptions()
);
// 此时可通过索引0获取返回的更新后值
String updatedValue = result.contentAs(0, String.class);

方式2：返回整个完整文档 #

通过returnDocument(ReturnDocument.ALL)配置，返回修改后的整个文档：

MutateInResult result = collection.mutateIn(
    "目标文档ID",
    Arrays.asList(MutateInSpec.upsert("目标JSON路径", "新值")),
    MutateInOptions.mutateInOptions().returnDocument(ReturnDocument.ALL)
);
// 获取完整文档内容
JsonObject fullUpdatedDoc = result.contentAs(0, JsonObject.class);

额外验证点 #

• 检查你的mutateIn调用是否确实遗漏了返回配置，默认returnValue为false，不会将修改的子文档加入结果集
• 确认Couchbase Server 7.1.3与SDK 3.3.4的兼容性（两者官方标注为兼容，可排除版本匹配问题）
• 开启SDK debug日志，查看请求中是否包含返回内容的指令，验证配置是否生效

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