本文介绍如何利用 Go 反射机制，将结构体字段自动转换为 sql.Scan 和 sql.Exec 所需的指针切片或值切片，避免手动重复书写字段地址，提升数据库操作代码的可维护性与 DRY 性。
本文介绍如何利用 go 反射机制，将结构体字段自动转换为 `sql.scan` 和 `sql.exec` 所需的指针切片或值切片，避免手动重复书写字段地址，提升数据库操作代码的可维护性与 dry 性。
在 Go 的数据库开发中，频繁地为 sql.Row.Scan() 或 sql.Stmt.Exec() 显式传入每个结构体字段的地址（如 &u.Email, &u.Id）不仅冗长易错，更违背 DRY（Don’t Repeat Yourself）原则——每当结构体新增字段或数据库表结构调整时，所有相关方法都需同步修改，极易遗漏并引发运行时 panic 或数据错位。
虽然引入成熟 ORM（如 GORM、SQLX）是推荐的工程化方案，但若希望轻量级、零依赖地实现自动化绑定，反射（reflection）是 Go 标准库提供的核心能力。关键在于：正确获取结构体字段的地址（用于 Scan），以及按顺序提取字段值（用于 Exec），同时兼顾类型安全与可读性。
✅ 正确获取字段指针：Field(i).Addr() 而非 Pointer()
你遇到的 panic：
panic: reflect: call of reflect.Value.Pointer on int64 Value
是因为 reflect.Value.Pointer() 仅适用于底层为指针、切片等“可寻址复合类型”的 Value，而 val.Field(0) 返回的是一个 int64 类型的 Value 实例（非指针），直接调用 .Pointer() 会 panic。
✅ 正确做法是：先确保 reflect.Value 是可寻址的（addressable），再调用 .Addr() 获取其地址（返回 reflect.Value，其 Kind 为 Ptr）：
func StructScanArgs(v interface{}) []interface{} {
rv := reflect.ValueOf(v)
if rv.Kind() != reflect.Ptr || rv.IsNil() {
panic("StructScanArgs: argument must be a non-nil pointer to struct")
}
rv = rv.Elem()
if rv.Kind() != reflect.Struct {
panic("StructScanArgs: argument must point to a struct")
}
var args []interface{}
for i := 0; i < rv.NumField(); i++ {
field := rv.Field(i)
if !field.CanAddr() {
panic("StructScanArgs: unexported field " + rv.Type().Field(i).Name + " cannot be addressed")
}
args = append(args, field.Addr().Interface())
}
return args
}该函数接收 *User，遍历其所有导出字段，对每个字段调用 .Addr().Interface()，得到 *int64、*string 等真实指针，最终返回 []interface{}，可直接传给 Scan：
user := &User{}
err := db.QueryRow(query, email).Scan(StructScanArgs(user)...)
if err != nil {
return nil, err
}✅ 自动化 Exec 参数：按字段顺序提取值
类似地，为 Exec 构造参数列表时，需提取结构体字段的值（而非地址），且跳过主键（如 Id）或只读字段（如 Joined 若由 DB 自动生成）。可通过结构体标签（tag）灵活控制：
func StructExecValues(v interface{}, skipFields ...string) []interface{} {
rv := reflect.ValueOf(v)
if rv.Kind() != reflect.Ptr || rv.IsNil() {
panic("StructExecValues: argument must be a non-nil pointer to struct")
}
rv = rv.Elem()
if rv.Kind() != reflect.Struct {
panic("StructExecValues: argument must point to a struct")
}
skipMap := make(map[string]bool)
for _, f := range skipFields {
skipMap[f] = true
}
var values []interface{}
for i := 0; i < rv.NumField(); i++ {
fieldName := rv.Type().Field(i).Name
if skipMap[fieldName] {
continue
}
field := rv.Field(i)
if !field.CanInterface() {
continue // 忽略不可导出字段
}
values = append(values, field.Interface())
}
return values
}使用示例（跳过 Id，因 INSERT 时不提供）：
_, err := stmt.Exec(StructExecValues(u, "Id")...)
⚠️ 注意事项与最佳实践
- 导出性要求：反射只能访问导出（大写开头）字段。确保 User 中所有需映射的字段均为导出字段（你当前定义已满足）。
- 字段顺序一致性：SELECT * 的列序必须严格匹配结构体字段声明顺序。强烈建议显式列出字段（如 SELECT id, email, ...），而非依赖 *，避免因表结构调整导致静默错位。
- 性能权衡：反射有运行时开销。若性能敏感（如高频查询），可考虑代码生成（go:generate + structfield）替代运行时反射。
- 错误处理增强：生产环境应补充字段类型校验（如 field.CanAddr()）、空值处理（sql.NullString 需特殊支持）、以及标签驱动的映射（如 db:"email"）以解耦结构体与表名。
- 替代方案推荐：对于中大型项目，优先评估 sqlx（轻量、基于反射、支持命名参数）或 GORM（全功能 ORM），它们已成熟解决此类问题，并提供事务、预加载等高级特性。
通过以上反射封装，你的 ByEmail 和 Create 方法将大幅精简，新增字段只需更新结构体定义，无需触碰 SQL 绑定逻辑——真正实现“一次定义，处处生效”。
