本文揭示go使用database/sql执行update时因占位符参数顺序错位导致“执行成功但未更新”的典型问题，并提供可复现的修复方案与最佳实践。
本文揭示go使用database/sql执行update时因占位符参数顺序错位导致“执行成功但未更新”的典型问题，并提供可复现的修复方案与最佳实践。
在Go语言中操作MySQL（或其他SQL数据库）时，UPDATE语句看似执行成功（无panic、无error），却始终无法修改数据——这是开发者常遇的“静默失败”陷阱。根本原因往往不在连接、事务或权限，而在于预处理语句（Prepare）中Exec参数的顺序与SQL占位符?的映射关系不匹配。
以问题代码为例，关键逻辑位于 updateDate 函数：
func updateDate(mydb *sql.DB, lastId int64) {
tx, err := mydb.Begin()
checkErr(err)
cmd := "UPDATE userinfo SET created = ? WHERE uid = ?" // 注意：第1个?对应created，第2个?对应uid
updateDate, err := tx.Prepare(cmd)
checkErr(err)
log.Println("•••• Updating record", lastId)
// ❌ 错误：参数顺序颠倒！
res, err := updateDate.Exec(lastId, "2015-09-02") // 传入：(uid, created) → 但SQL期望 (created, uid)
checkErr(err)
updateDate.Close()
err = tx.Commit()
checkErr(err)
affect, err := res.RowsAffected()
checkErr(err)
fmt.Println("Records affected", affect) // 输出 Records affected 0
}
SQL语句 "UPDATE userinfo SET created = ? WHERE uid = ?" 中，两个 ? 严格按从左到右顺序绑定：
- 第1个 ? → created 字段值（应为 "2015-09-02"）
- 第2个 ? → WHERE uid = ? 的条件值（应为 lastId）
而原代码调用 updateDate.Exec(lastId, "2015-09-02") 却将 lastId 传给了第1个占位符（即试图把ID赋给created字段），将日期字符串传给了第2个占位符（即用日期字符串去匹配uid整型主键）。由于uid是serial（即BIGINT），MySQL会尝试隐式转换"2015-09-02"为整数，结果为2015（截断至首个非数字前），而实际插入的uid是3，因此WHERE uid = 2015不匹配任何行，最终RowsAffected()返回0——更新“成功”却零影响。
✅ 正确写法（修正参数顺序）：
// ✅ 正确：参数顺序必须与SQL中?出现顺序完全一致
res, err := updateDate.Exec("2015-09-02", lastId) // created 值在前，uid 条件在后
? 进阶建议与注意事项：
- 启用查询日志验证实际执行：在开发环境开启MySQL通用日志或使用sql.Open("mysql", "user:pass@tcp(...)dbname?interpolateParams=true&parseTime=true")配合log.SetFlags(log.Lshortfile)观察真实SQL。
- 使用命名参数替代?（需驱动支持）：如github.com/go-sql-driver/mysql不原生支持命名参数，但可借助sqlx库（sqlx.NamedExec("UPDATE ... SET created = :date WHERE uid = :id", map[string]interface{}{"date": "2015-09-02", "id": lastId})）彻底规避顺序风险。
- 务必检查RowsAffected()：即使err == nil，也应验证res.RowsAffected() > 0，作为业务逻辑是否生效的关键判断依据。
- 事务内操作需显式Commit()或Rollback()：本例已正确提交，但若Commit()前发生panic，需用defer确保回滚（示例中未体现，生产环境应补充）。
总结：Go的database/sql对SQL占位符采用严格的位置绑定（positional binding），而非名称绑定。开发者必须将Exec参数列表视为SQL中?序列的线性映射——顺序即契约。一次疏忽的参数颠倒，就会让UPDATE变成“无效空转”。养成编写SQL后立即对照占位符顺序检查参数的习惯，是避免此类低级但致命错误的最有效防御。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
