struct字段必须导出且带db标签，非导出字段无法被reflect读取；无db标签字段即使导出也被忽略；嵌套结构不自动展开；INSERT/UPDATE需区分零值与nil；WHERE等动态SQL须参数化防注入；JOIN/ORDER BY等复杂逻辑不可依赖反射。
struct字段必须导出且带db标签
非导出字段（首字母小写）无法被reflect读取值，更无法写入SQL语句；没有db标签的字段默认被忽略，哪怕它导出也无法参与映射。SQLx、GORM等主流库都依赖db:"column_name"这类标签做列名绑定。
常见错误现象：生成的SQL里字段缺失、列名用的是Go字段名（如UserName变成username而非user_name），或整条INSERT语句只拼出INSERT INTO table () VALUES ()空括号。
- 确保所有参与SQL生成的字段首字母大写（即导出）
- 每个字段显式声明
db标签，例如UserName string `db:"user_name"` - 空标签
db:"-"可主动排除字段，比靠命名规则更可靠 - 嵌套结构体不会自动展开——反射只处理一级字段，深层结构需手动递归或扁平化
INSERT/UPDATE语句要区分零值与nil
反射拿到reflect.Value后，直接用.Interface()取值前必须检查.IsValid()和.CanInterface()，否则遇到nil指针、空interface或未初始化字段会panic。更重要的是：SQL中0、""、false是有效值，不能当成“未设置”跳过；而nil指针或sql.NullString类型的.Valid=false才该被忽略或转为NULL。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 对指针字段，先用
v.Kind() == reflect.Ptr && v.IsNil()判断是否为nil - 对
sql.Null*类型，需额外检查.Valid字段（得用反射取其成员） - 避免用
v.IsZero()统一过滤——它会把int(0)也当空值处理，导致INSERT丢失合法默认值 - UPDATE语句建议显式列出待更新字段，而不是“非零值才SET”，否则可能误删数据
WHERE条件生成必须防御空值和恶意字符串
用反射拼WHERE子句时，若直接把用户输入的string字段塞进fmt.Sprintf("name = '%s'", v)，等于亲手打开SQL注入大门。正确做法是：只用反射提取字段名和对应值，**值本身不参与字符串拼接**，而是交给database/sql的参数化查询机制处理。
- 反射只负责生成形如
"name = ? AND status = ?"的占位符模板 - 字段值收集到
[]interface{}切片中，按顺序传给db.Query(query, args...) - 禁止对字段值做任何
strconv或fmt.Sprintf转义——那是驱动该干的事 - 若需动态字段（如
map[string]interface{}），也要坚持键做白名单校验，值走参数化
JOIN和ORDER BY不能靠反射自动生成
反射能安全处理单表的CRUD字段映射，但涉及多表关联、嵌套查询、聚合函数、动态排序时，硬编码规则极易出错。比如reflect无法判断CreatedAt该映射到users.created_at还是orders.created_at，也无法理解"DESC NULLS LAST"这种数据库方言。
- JOIN条件、ON子句、GROUP BY、HAVING、复杂ORDER BY应由调用方显式传入字符串或结构体配置
- 可封装
JoinClause{Table: "orders", On: "users.id = orders.user_id"}这类类型，反射只解析其字段，不推导逻辑 - 排序字段若来自用户输入，必须经白名单过滤（如
map[string]string{"name": "users.name", "time": "orders.created_at"}） - 别指望反射自动加表别名——它不知道你写的
Name到底属于哪张表
关键点在于：反射适合做**静态、单层、确定性**的映射，一旦涉及跨表、动态逻辑、上下文敏感操作，就必须退回到显式控制。很多团队踩坑是因为把“自动”当成了“智能”，结果WHERE里拼出id = 0 OR 1=1，或者JOIN把用户表和日志表笛卡尔积了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
