Go结构体字段名与数据库列名不一致时，reflect仅能读取导出字段（首字母大写）的标签，且必须用field.Tag.Get("db")显式提取；若未加db:"xxx"标签或字段未导出，返回空字符串，导致SQL列名错误或静默失效。
struct 字段名和数据库列名不一致时，reflect 拿不到正确字段标签
Go 的 reflect 默认只能读取导出字段（首字母大写），且必须显式通过 StructTag 提取 gorm 或 json 这类标签。如果你没在 struct 上加 gorm:"column:name" 或自定义标签（比如 db:"user_name"），reflect.StructField.Tag.Get("db") 会返回空字符串，导致生成的 SQL 列名直接用 Go 字段名（如 UserName → user_name 就断掉了）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 统一用
db标签声明列名：type User struct { ID int `db:"id"` UserName string `db:"user_name"` Email string `db:"email"` } - 遍历字段时检查
field.Tag.Get("db")是否为空；为空则跳过或 panic，别 fallback 到field.Name驼峰转下划线——那只是猜测，不是约定 - 注意嵌套结构体：反射默认不递归展开，
field.Type.Kind() == reflect.Struct时需手动进入，否则漏字段
生成 SELECT 语句时，reflect.Value 无法直接判断零值是否该参与 WHERE 条件
比如 User{ID: 0, Email: "a@b.com"}，你希望生成 WHERE email = ?，但 ID 是 0（int 零值），不该出现在 WHERE 中。可 reflect.Value.IsZero() 对指针、切片、map 有效，对基本类型（int, string）也生效，但它不会区分“用户真的传了 0”和“压根没设值”。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 只对指针字段（
*int,*string）用IsNil()判断是否忽略；对值类型字段（int,string）默认参与 WHERE —— 否则逻辑模糊，容易漏条件 - 若需支持“零值过滤”，改用指针字段或额外加
db:",omitempty"类似语义，并手动解析 tag - 避免在反射循环里拼接 SQL 字符串，用
strings.Builder累积列名和占位符，最后再strings.Join()，性能更稳
用 reflect 生成 INSERT 语句时，忽略 db:"-" 和 db:"id,omitempty" 字段
有些字段不该入库（如 PasswordHash），或由数据库自增（ID）。如果反射时没检查 tag，就会把它们塞进 INSERT INTO ... VALUES，轻则报错，重则覆盖敏感数据。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 遍历每个
StructField前，先检查field.Tag.Get("db") == "-"，直接 continue - 对带
omitempty的字段（如db:"status,omitempty"），需额外判断值是否为零值；但注意：仅限你明确控制该字段“可空”的场景，不要全局启用 -
INSERT的 VALUES 占位符必须和字段顺序严格对应，别依赖 map 遍历顺序（Go map 无序），老实用 slice 保存字段名 + 值的 pair
反射性能差，高频查询场景下别在每次请求中反复调用 reflect.TypeOf
每次调用 reflect.TypeOf(v) 和遍历字段都是 runtime 开销。如果一个 User struct 被用来生成几百次 SQL，反复反射会明显拖慢吞吐。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在程序启动时（
init()或sync.Once）缓存每个 struct 类型的字段映射：map[reflect.Type][]dbFieldMeta，其中dbFieldMeta包含列名、是否忽略、是否指针等 - 缓存 key 必须用
reflect.Type，别用fmt.Sprintf("%v", v)—— 不稳定且慢 - 如果用了 GORM 等 ORM，优先复用其已有的 schema 缓存（如
gorm.Model(&User{}).Statement.Schema），比手撸反射更可靠
真正难的不是怎么用 reflect 取字段，而是决定哪些字段该进 SQL、以什么形式进、在什么条件下进——这些规则必须显式编码，不能靠反射自动猜。
