sqlx.Open 后必须调用 db.Ping() 才能验证数据库连通性、驱动加载和 DSN 格式，否则首次查询可能 panic 或返回空数据；同时需显式配置 parseTime=true 和 loc=UTC，并设置连接池参数。
sqlx.Open 为什么不能直接用，必须配 db.Ping()
很多人写完 sqlx.Open 就直接执行查询，结果偶尔 panic 或返回空数据——这是因为 sqlx.Open 只是初始化连接池配置，并不校验数据库是否可达。真正建立首个连接、触发驱动加载、验证 DSN 格式，要靠 db.Ping()。
常见错误现象：sql: database is closed（实际是还没成功 open）、或首次查询超时却无明确报错。
- 必须在
sqlx.Open后立刻调用db.Ping()，并检查 error - DSN 中的
parseTime=true和loc=UTC要显式加上，否则time.Time字段可能解析失败或时区错乱 - 连接池参数建议在 open 后设置：
db.SetMaxOpenConns(20)、db.SetMaxIdleConns(10)，避免默认值（0 / 2）在高并发下打满 DB
QueryRowx + StructScan 比 Scan 更安全但有约束
用 db.QueryRowx().StructScan(&u) 替代手写 Scan() 是 sqlx 的核心优势，但前提是 struct 字段名和 SQL 列名严格匹配（或通过 dbms 标签映射），否则静默跳过字段。
常见错误现象：struct 字段没被赋值、零值返回、或 panic 报 sql: expected 3 destination arguments in Scan, not 4。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- SQL 中列别名必须和 struct 字段名一致，例如
SELECT id AS ID, name AS Name FROM users（若字段是ID、Name） - 推荐统一用小写字段 +
dbtag：type User struct { ID int `db:"id"` Name string `db:"name"` } - 如果 SQL 返回了未定义在 struct 中的列（比如加了
created_at AS ct但 struct 没Ct字段），StructScan会忽略它，不报错也不警告
NamedExec 处理动态 WHERE 条件时容易漏掉指针
用 sqlx.NamedExec 写带命名参数的 INSERT/UPDATE 很方便，但拼动态 WHERE 时，常有人把 map 值写成字面量而非地址，导致更新不生效。
常见错误现象：UPDATE 影响行数为 0，但 SQL 语法正确、日志里参数也看着对。
- 传给
sqlx.NamedExec的参数必须是 struct 指针或 map[string]interface{}，不能是 struct 值（否则字段无法被反射寻址） - 动态条件建议用
map[string]interface{}构造，例如：args := map[string]interface{}{"name": name, "status": status}，再db.NamedExec("UPDATE u SET ... WHERE name = :name AND status = :status", args) - 注意 nil 值：如果
status是nil，而数据库字段是 NOT NULL，语句会执行失败；需提前过滤或改用COALESCE(:status, status)
事务中嵌套 Queryx 调用必须用 *sqlx.Tx
在事务里混用 db.Queryx 和 tx.Queryx 是高频翻车点：前者走的是全局连接池，后者才走事务上下文。一旦用错，查询就脱离事务，造成数据不一致。
常见错误现象：事务 rollback 了，但之前某个 db.Get() 还拿到了中间态数据；或事务中 SELECT 结果和后续 UPDATE 不匹配。
- 开启事务后，所有操作必须基于
*sqlx.Tx对象，例如tx := db.Beginx()，然后用tx.Queryx()、tx.NamedExec() - 不要在事务中调用
db.Get()或db.Select()—— 它们永远不参与当前事务 - 事务结束前，记得调用
tx.Commit()或tx.Rollback()；建议用defer tx.Rollback()开头，再在成功时tx.Commit()并return
