本文介绍在 google app engine（gae）go 环境中，当 datastore 已存有旧版结构数据、而新代码希望忽略某些废弃字段时，如何避免 `datastore.errfieldmismatch` 导致的加载失败，无需重写全部 `load`/`save` 方法。
在 GAE Go 的 google.golang.org/appengine/datastore（v1）中，Datastore 默认采用严格的结构体映射机制：若实体包含结构体未定义的字段（如已弃用的 NotImportant），调用 datastore.Get() 或 datastore.GetAll() 加载时会返回 *datastore.ErrFieldMismatch 错误，而非静默跳过——这与 Go 标准库 json 或 encoding/gob 的宽松行为不同。
幸运的是，你无需为每个结构体手动实现 Load/Save。最轻量、推荐的解决方案是：捕获并忽略 datastore.ErrFieldMismatch 错误，同时透传其他真正异常。例如：
var foo Foo
key := datastore.NameKey("Foo", "some-id", nil)
if err := client.Get(ctx, key, &foo); err != nil {
if _, ok := err.(*datastore.ErrFieldMismatch); ok {
// 字段不匹配（如存在 NotImportant 字段但结构体已移除），可安全忽略
// 继续使用已成功填充的字段（如 Important）
} else {
// 其他错误（如网络超时、权限不足、key 无效等），需正常处理
log.Printf("Failed to load Foo: %v", err)
return err
}
}
// 此时 foo.Important 已正确赋值，可安全使用
fmt.Println("Important:", foo.Important)⚠️ 注意事项：
- 此方法仅适用于 读取（Get/GetAll/Next）场景；写入（Put）时，未导出或无 datastore tag 的字段本就不会被保存，无需额外处理。
- ErrFieldMismatch 是指 实体中存在结构体未声明的字段，不是字段类型不匹配（后者会报 ErrInvalidEntityType 等）。
- 若需更精细控制（如迁移旧数据、记录缺失字段），可在捕获 ErrFieldMismatch 后，改用 datastore.PropertyList 先读取原始属性，再选择性赋值。
- GAE Go v1 SDK 已归档，新项目应迁移到 Cloud Datastore / Firestore with cloud.google.com/go/datastore（其行为更现代，支持 omitempty tag 和更灵活的结构体映射，但需注意 API 差异）。
总结：通过类型断言精准识别并忽略 *datastore.ErrFieldMismatch，即可在零结构体改造成本下实现“向后兼容的字段淘汰”，是 GAE Go Datastore 迁移中最实用的轻量级技巧。
