17370845950

在 google app engine 的 go datastore 中，当结构体字段被废弃但数据库中仍存有旧数据时，可通过 `datastore.errfieldmismatch` 捕获并静默处理不匹配字段，避免加载失败，无需重写全部 `load`/`save` 方法。

Google App Engine（GAE）Go SDK 的 Datastore 客户端在从实体加载数据到结构体时，会严格校验字段一致性：若存储的实体包含结构体中不存在的字段（如已废弃的 NotImportant），默认会返回 *datastore.ErrField

Mismatch 错误，导致 datastore.Get() 或 datastore.GetAll() 失败。

幸运的是，该错误是可识别、可安全忽略的。你无需为每个结构体重写 Load() 和 Save() 方法——只需在调用 datastore.Get() 等操作后，显式检查并忽略该特定错误即可。示例如下：

var foo Foo
key := datastore.NameKey("Foo", "some-id", nil)
err := client.Get(ctx, key, &foo)
if err != nil {
    if _, isMismatch := err.(*datastore.ErrFieldMismatch); isMismatch {
        // 字段不匹配（如实体含 NotImportant，但结构体已移除），可安全忽略
        // 继续使用已成功填充的字段（如 Important）
    } else {
        // 其他真实错误（如网络超时、权限拒绝等），需正常处理
        log.Printf("Datastore get failed: %v", err)
        return err
    }
}
// 此时 foo.Important 已正确加载，程序可继续执行

⚠️ 注意事项：

• ErrFieldMismatch 仅在 加载（Get/GetAll）时触发，不影响保存（Put）；移除字段后新写入的数据自然不再包含它；
• 此方式属于“前向兼容”策略，适用于只读废弃字段场景；若后续还需写入或迁移旧数据，建议配合后台任务逐步清理；
• 不要忽略所有错误——必须精确判断 err 是否为 *datastore.ErrFieldMismatch，否则可能掩盖严重问题；
• Go 1.13+ 推荐使用 errors.As() 进行类型断言，更健壮：

  var mismatchErr *datastore.ErrFieldMismatch
  if errors.As(err, &mismatchErr) {
      // 忽略字段不匹配
  }

总结：通过精准捕获 *datastore.ErrFieldMismatch，你能在零结构体改造成本的前提下，平滑过渡废弃字段，保障存量数据可读、服务持续可用——这是 GAE Go Datastore 提供的轻量级 schema 演进方案。