如何在Google Cloud Datastore中安全弃用字段？Go语言兼容疑问

我正在开发一个API，涉及创建Datastore实体并通过异步回调延迟读取。为了便于回滚，我尝试更新Go语言Datastore库使用的结构体以安全移除字段，但移除后新代码无法处理旧代码创建的实体结构，出现报错。

旧代码（创建实体） #

type Entity struct {
  ActiveField string
  UnusedField string // TODO: 弃用
}

value := Entity{ActiveField: "my-value"}

client.Put(ctx, key47, value)

新代码（读取实体） #

type Entity struct {
  ActiveField string
}
value := Entity{}
err := client.Get(ctx, key47, value) // --> 报错

报错信息 #

datastore: cannot load field "UnusedField" into a "service.Entity": no such struct field

我找到一个临时解决方法：

err := datastore.get()
if err != nil && !strings.Contains(err.Error(), "no such struct field") {
  return err
}     

疑问解答 #

(A) 该解决方法是否正确，能否正常获取其他字段？

这个方法能让代码绕过字段缺失的错误继续运行，已存在的ActiveField会被正常加载——因为Datastore在读取时会先完成匹配字段的赋值，仅在遇到无法映射的字段时抛出错误。但这种方式存在明显缺陷：

• 它依赖错误文本的硬匹配，若后续Datastore SDK修改错误信息格式，判断逻辑会直接失效。
• 会掩盖其他真实错误，比如字段类型不匹配等本该被处理的问题，增加调试难度。

(B) 使用Datastore进行向后兼容的最佳实践有哪些？

• 逐步弃用字段，避免直接删除：
  先在结构体中保留字段，添加datastore:"unusedField,omitempty"标签（字段名需与Datastore中存储的属性名对应），同时代码中不再使用该字段。等所有旧实体都被新代码覆盖（或确认无旧实体再被读取）后，再删除字段。
• 用datastore.PropertyList灵活读取：
  通过PropertyList读取所有属性后手动映射，主动忽略不需要的字段，示例：

  var props datastore.PropertyList
  if err := client.Get(ctx, key47, &props); err != nil {
    return err
  }
  var entity Entity
  for _, prop := range props {
    if prop.Name == "ActiveField" {
      entity.ActiveField = prop.Value.(string)
    }
    // 主动忽略UnusedField
  }
  

• 添加ignore标签临时兼容：
  在新结构体中临时添加被移除的字段，并标记datastore:"-"，SDK读取时会自动跳过该字段，不会抛出错误：

  type Entity struct {
    ActiveField string
    UnusedField string `datastore:"-"` // 读取时忽略该字段
  }
  

  这种方式比硬编码错误文本更可靠，等确认旧实体全部处理完成后，再删除这个临时字段。
• 批量数据迁移：
  运行批量任务遍历所有实体，移除UnusedField属性，确保所有实体符合新结构体格式后，再删除代码中的对应字段。这种方式最彻底，但需根据数据量评估迁移成本。

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