使用Go的gocb库更新Couchbase文档指定字段（仅文档存在时）

gocb完全支持你要的这种场景，不需要先获取完整文档，直接用MutateIn方法配合存在性校验选项就能实现。

核心实现思路 #

• 使用Collection.MutateIn方法：这是Couchbase官方推荐的部分文档更新API，直接在服务器端修改指定字段，无需拉取完整文档。
• 启用Exists校验：通过MutateInOptions设置Exists: true，强制要求目标文档必须存在，否则操作失败并返回明确的文档不存在错误。

代码示例 #

package main

import (
	"errors"
	"fmt"
	"github.com/couchbase/gocb/v2"
)

func main() {
	// 假设已完成集群、桶、集合的初始化（此处省略初始化代码）
	// var collection *gocb.Collection

	opts := gocb.MutateInOptions{
		Exists: true, // 开启文档存在性校验
	}

	// 定义要执行的更新操作：比如更新info.age字段为30
	updateSpecs := []gocb.MutateInSpec{
		gocb.UpsertSpec("info.age", 30, nil),
	}

	_, err := collection.MutateIn("target-doc-id", updateSpecs, &opts)
	if err != nil {
		if errors.Is(err, gocb.ErrDocumentNotFound) {
			fmt.Println("错误：文档不存在，无法执行更新操作")
		} else {
			fmt.Printf("更新操作失败：%v\n", err)
		}
		return
	}

	fmt.Println("指定字段更新成功")
}

关键细节说明 #

• 更新操作类型：除了UpsertSpec（字段不存在则插入，存在则更新），你还可以根据需求使用ReplaceSpec（仅字段存在时更新）、InsertSpec（仅字段不存在时插入）等不同的MutateInSpec类型。
• 错误处理：捕获gocb.ErrDocumentNotFound错误即可精准判断文档不存在的场景，进而输出对应的错误提示。

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