如何将protoc-gen-go生成的结构体存入Firestore并忽略指定字段？

1. 修改Proto文件添加Firestore忽略标签（推荐） #

Firestore Go SDK会识别结构体上的firestore:"-"标签，标记该字段不参与存储。可以在Proto文件中通过go_field_option给resource_name字段添加这个标签：

message Document {
  string resource_name = 1 [
    (google.api.field_behavior) = OUTPUT_ONLY,
    option go_field_option = "firestore:\"-\""
  ];
  string title = 2;
}

重新生成Go代码后，resource_name字段会带有firestore:"-"注解，调用Set时就会自动忽略该字段，无需额外处理。

2. 存储时指定FieldMask #

如果无法修改Proto文件，可以在调用Set方法时通过firestore.FieldMask指定仅存储title字段：

document := Document{Title: "test title"}
dRef := someCollection.NewDoc()
// 仅存储title字段
_, err = dRef.Set(ctx, &document, firestore.FieldMask("title"))

这种方式直接告诉Firestore只处理指定字段，其余字段会被忽略，无需额外转换。

3. 使用临时结构体/Map（兼容方案） #

如果上述两种方式都不适用，可以创建仅包含需要存储字段的临时结构体或Map，转换后再存储：

临时结构体方式：

// 定义仅包含title的临时结构体
type firestoreDocument struct {
  Title string `firestore:"title"`
}

document := Document{Title: "test title"}
tempDoc := firestoreDocument{Title: document.Title}
dRef := someCollection.NewDoc()
_, err = dRef.Set(ctx, tempDoc)

Map方式：

document := Document{Title: "test title"}
dRef := someCollection.NewDoc()
_, err = dRef.Set(ctx, map[string]interface{}{"title": document.Title})

关于OUTPUT_ONLY不生效的说明 #

Google API的field_behavior = OUTPUT_ONLY注解仅对Google API相关服务（如API Gateway、gRPC Gateway）生效，Firestore Go SDK并不会识别该注解，因此无法自动忽略该字段，需要通过上述方式手动控制。

读取时填充resource_name #

读取文档时，你采用的方式是可行的：

dRef := someCollection.Doc(uid)
dSnap, err := dRef.Get(ctx)
if err != nil {
  // 处理错误
}
document := Document{}      
err = dSnap.DataTo(&document)
if err != nil {
  // 处理错误
}
document.ResourceName = "document/" + dSnap.Ref.ID

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