本文介绍如何利用 Go 反射机制优雅实现 REST API 中的稀疏更新（partial update），避免为每个字段手动编写冗余的 choose 逻辑，提升代码可维护性与扩展性。
本文介绍如何利用 go 反射机制优雅实现 rest api 中的稀疏更新（partial update），避免为每个字段手动编写冗余的 `choose` 逻辑，提升代码可维护性与扩展性。
在构建 RESTful API 时，客户端常通过 PATCH 请求提交部分字段（sparse update）以修改资源。当底层数据存储不支持原生稀疏更新（如多数键值存储或简单 ORM），服务端需将传入的“补丁对象”与数据库中读取的“原始对象”进行安全合并：仅用新值覆盖非 nil 字段，其余保留原值。传统方式（如问题中所示）需为每个字段显式调用辅助函数（如 choose），不仅代码冗长，更易因新增字段而遗漏更新逻辑，违反 DRY 原则。
使用反射可将该逻辑泛化为通用结构体合并操作。核心思想是：遍历结构体所有导出字段，若“新值”字段非 nil，则采用它；否则沿用“旧值”。以下是一个生产就绪的反射合并实现：
import "reflect"
// Update merges src into dst: for each field, uses src's value if non-nil, otherwise keeps dst's.
// Both dst and src must be struct values of the same type.
func Update(dst, src interface{}) {
dstVal := reflect.ValueOf(dst).Elem()
srcVal := reflect.ValueOf(src)
if dstVal.Type() != srcVal.Type() {
panic("Update: mismatched struct types")
}
for i := 0; i < dstVal.NumField(); i++ {
dstField := dstVal.Field(i)
srcField := srcVal.Field(i)
// 跳过不可设置字段（如未导出字段）
if !dstField.CanSet() {
continue
}
// 仅处理指针字段（适配 JSON sparse update 场景）
if srcField.Kind() == reflect.Ptr && !srcField.IsNil() {
dstField.Set(srcField)
}
}
}使用示例如下：
type Model struct {
ID *string `json:"id"`
Name *string `json:"name"`
Email *string `json:"email"`
Active *bool `json:"active"`
}
func UpdateController(input Model) error {
id := *input.ID
previous, err := store.Get(id)
if err != nil {
return err
}
// 创建副本并合并
updated := previous
Update(&updated, input) // 注意：dst 必须传指针，src 传值即可
return store.Put(updated)
}⚠️ 关键注意事项：
- 仅适用于指针字段：本方案专为 JSON sparse update 设计（字段为 *T 类型），因 nil 是判断“客户端未提供该字段”的可靠依据；若字段为值类型（如 string），无法区分“空字符串”与“未提供”，需额外标记（如使用 sql.NullString 或自定义标记字段）。
- 类型安全与性能权衡：反射带来灵活性，但牺牲编译期类型检查和运行时性能。在高吞吐场景，可考虑代码生成工具（如 stringer 风格）预生成类型专属合并函数。
- 嵌套结构体不自动递归：当前实现仅处理顶层字段。若需深度合并（如嵌套结构体也支持稀疏更新），需递归处理 reflect.Struct 类型字段，并增加循环检测。
- 错误处理增强建议：实际项目中应补充对非导出字段、不可设置字段、类型不匹配等异常的明确错误返回，而非 panic。
总结而言，反射式结构体合并是解决 Go 中稀疏更新问题的简洁、可复用方案。它显著降低模板代码量，提升模型演进时的健壮性。只要明确其适用边界（指针字段 + 同构结构体），并在关键路径评估性能影响，即可成为 REST API 服务层的标准实践之一。
