Go中struct字段到SQL列名映射需用db标签显式定义,不可依赖reflect自动推导;INSERT时仅指针类型为nil才插入NULL,非指针字段无论零值均如实插入。

struct字段到SQL列名映射必须手动控制
Go原生reflect无法自动推断数据库列名,比如UserName该转成user_name还是username,必须显式定义规则。不加约束直接用field.Name生成SQL会直接报错或查不到数据。
推荐做法是统一用结构体标签(struct tag)声明列名:
type User struct {
ID int64 `db:"id"`
Name string `db:"name"`
Age int `db:"age"`
}
反射时读取field.Tag.Get("db"),空值则跳过或panic,不 fallback 到驼峰转下划线——那属于业务逻辑,不该由反射层隐式承担。
INSERT语句拼接要区分零值与nil
Go没有null引用,int、string等类型零值(0、"")是否插入数据库,取决于字段是否允许NULL或是否有默认值。不能简单把所有零值当NULL处理。
立即学习“go语言免费学习笔记(深入)”;
- 用
field.IsNil()只对指针、map、slice、func、chan、interface有效;基础类型得靠field.Interface()后类型断言判断 - 建议只对
*T类型字段支持NULL:若field.Kind() == reflect.Ptr && field.IsNil(),才生成NULL - 非指针字段一律按真实值插入,哪怕为
0或""
示例片段:
v := reflect.ValueOf(user).Elem()
for i := 0; i < v.NumField(); i++ {
field := v.Field(i)
tag := v.Type().Field(i).Tag.Get("db")
if tag == "" || tag == "-" {
continue
}
if field.Kind() == reflect.Ptr && field.IsNil() {
// 生成 NULL
} else {
// 用 fmt.Sprintf("%v", field.Interface()) 转字符串(注意time.Time需特殊处理)
}
}
UPDATE语句必须排除主键和不可更新字段
反射遍历所有字段生成SET col = ?会误更新ID或CreatedAt这类只读字段,导致数据错乱。不能依赖“字段名含ID就跳过”这种弱规则。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
明确用标签区分:
-
db:"id,pk"表示主键,UPDATE时不出现 -
db:"created_at, readonly"表示只读字段,INSERT/UPDATE都不出现 -
db:"-"完全忽略该字段
解析tag时拆分逗号,用strings.Contains(tagParts, "pk")或strings.Contains(tagParts, "readonly")判断,比字符串前缀匹配更可靠。
QueryRow Scan必须严格匹配字段顺序和类型
反射做Scan时,rows.Scan()接收的是[]interface{},每个元素必须是指针。常见错误是传field.Addr().Interface()失败——当field.CanAddr()为false(如struct字面量、非导出字段、嵌套值),会panic。
安全写法:
- 只处理
field.CanAddr() == true的字段 - 对
time.Time等特殊类型,提前转换为*time.Time再取地址 - 跳过未导出字段(
field.PkgPath() != "") - 确保SQL查询字段顺序与struct字段顺序一致,否则Scan错位
别指望反射能自动对齐列名和字段名——那是ORM干的事,原生反射只负责按序绑定。
最麻烦的其实是时间类型和JSON字段的序列化/反序列化,这些没法靠reflect.Value.Interface()一招通吃,得单独判断field.Type()再分支处理。

















