用reflect识别主键需检查结构体字段的db标签是否含"pk"或"primaryKey",跳过非导出字段,递归处理嵌入字段;生成UPDATE时WHERE仅用主键字段,SET子句排除主键且可选跳过零值或omitempty字段;SQL模板应预定义,参数通过Interface()安全绑定。

怎么用 reflect 识别结构体里的主键字段
反射本身不定义“主键”,它只读标签。真正起作用的是你约定的标签格式,比如 gorm:"primaryKey" 或 db:"id,pk"。关键不是“有没有主键”,而是你是否在字段上显式写了能被识别的标记。
常见错误是只写 db:"id" 就以为它是主键——反射可不管语义,它只认你明确写的 pk、primaryKey 这类关键词。
- 遍历每个
reflect.StructField,调用field.Tag.Get("db") - 若返回非空字符串,再检查是否包含
"pk"或"primaryKey"(注意大小写,建议统一小写后查找) - 跳过
field.PkgPath != ""的字段(即非导出字段),它们无法被数据库写入 - 别忘了处理嵌入字段:若
field.Anonymous && field.Tag.Get("db") == ",inline",需递归展开并继承主键标记逻辑
生成 UPDATE SQL 时,WHERE 子句怎么只用主键字段
UPDATE 必须带 WHERE,否则就是全表更新。而 WHERE 的字段只能来自主键——这是安全底线。反射能帮你自动提取,但前提是主键字段唯一且已正确标记。
实操要点:
- 先用上一节方法找出所有主键字段,存入切片
pkFields - 遍历
pkFields构建WHERE id = ? AND tenant_id = ?,顺序必须和后续Exec()参数一致 - 如果找不到任何主键字段,直接 panic 或返回 error——这比静默生成无 WHERE 的 SQL 更安全
- 避免用 map 存主键映射,因为 map 遍历无序,会导致占位符
?和参数错位
非主键字段怎么决定是否参与 SET 子句
ORM 常见需求是“部分更新”:只把非零值字段写进 SET,避免把 0、""、nil 错误覆盖到数据库。反射提供了 field.IsZero()(Go 1.13+),但它对指针、切片、map 等类型判断准确,对自定义类型或时间需要额外处理。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 对每个非主键字段,先调用
valueField.IsZero()判断是否为空 - 特别注意指针字段:
*string类型,nil是零值,但new(string)后赋值为""就不是零值——业务上可能仍想跳过 - 时间字段推荐用
time.Time.IsZero()而非IsZero(),因后者对 time.Time 总返回 true - 如果字段带
db:",omitempty"标签,就按此规则跳过;没标签则一律参与(除非是零值)
为什么不能直接用 reflect.Value.Interface() 拼 SQL 字符串
因为这等于放弃类型安全,把值直接塞进字符串,极易触发 SQL 注入、NULL 写入、时间格式错乱。比如 name := "admin'; DROP TABLE users; --",用反射拼成 "UPDATE user SET name = '" + name + "'" 就完蛋了。
真正该做的是:
- 用反射只生成字段名列表(如
[]string{"name", "email"})和主键名列表(如[]string{"id"}) - SQL 模板写死:
"UPDATE user SET name = ?, email = ? WHERE id = ?" - 参数用
reflect.Value.Field(i).Interface()提取一次,传给stmt.Exec(),由 database/sql 或 pgx 自动绑定 - 别在运行时拼接表名或列名——这些必须来自白名单或配置,不能由用户输入驱动
最易被忽略的一点:主键字段在 SET 子句里出现,是严重逻辑错误。反射提取字段时必须严格区分“用于 WHERE”和“用于 SET”,两者互斥。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










