Go sqlx使用Preparex+Context执行SQL报expected 8 arguments got 0问题

你出现sql: expected 8 arguments, got 0报错的核心原因是混淆了context.Context的作用边界：

• context.Context仅用于在请求链路中传递超时/取消信号、跨切面元数据（比如链路追踪ID、用户认证令牌），sqlx 不会主动解析ctx中存储的键值对作为SQL占位符的入参。
• 你将ID、Username等SQL需要的业务参数通过context.WithValue存入ctx，调用执行方法时没有在ctx之后传入对应占位符的实际参数，驱动自然识别到传入参数数量为0。
• 额外用法错误：插入操作属于写操作，你调用SelectContext执行插入是不对的，SelectContext用于执行查询类SQL并将返回的结果集扫描为目标结构，写操作需要调用ExecContext。

• db.Preparex的作用是提前将带位置占位符（?）的SQL发送到数据库端完成语法校验、执行计划预生成，返回的*sqlx.Stmt实例绑定了这条预编译SQL，后续执行时不需要重复发送SQL全文，仅需要传入占位符对应的位置参数即可。
• 所有带Context后缀的sqlx执行方法，第一个参数固定接收context.Context，从第二个参数开始才是SQL占位符对应的实际入参，ctx本身和SQL参数解析完全无关。
• 你之前使用的db.NamedExec是sqlx提供的命名参数语法糖，会自动从传入的结构体、map中匹配:字段名格式的命名参数取值，这个逻辑不会自动在普通*sqlx.Stmt的执行流程中生效，更不会从ctx中取值匹配。

方式1：使用位置占位符的普通预编译语句 #

1. 预编译阶段确认SQL的8个?占位符顺序和你要传入的字段顺序完全一致：

// 8个?对应8个插入字段，顺序必须和后续传参顺序一致
const insertUserSQL = `INSERT INTO users (id, username, password, field3, field4, field5, field6, field7) 
VALUES (?, ?, ?, ?, ?, ?, ?, ?)`

var insertUserStmt *sqlx.Stmt

// 初始化时完成预编译
func InitPreparedStmts(db *sqlx.DB) error {
    var err error
    insertUserStmt, err = db.Preparex(insertUserSQL)
    return err
}

2. 执行方法中，第一个参数传ctx，后续按占位符顺序传入8个实际参数，调用ExecContext执行插入：

func InsertUserData(ctx context.Context, u User) error {
    // 第一个参数为ctx，后面按SQL占位符顺序依次传参，共8个
    _, err := insertUserStmt.ExecContext(ctx,
        u.ID,
        u.Username,
        u.Password,
        u.Field3,
        u.Field4,
        u.Field5,
        u.Field6,
        u.Field7,
    )
    return err
}

方式2：使用命名参数的预编译语句 #

如果你不想手动按顺序传参，想直接绑定User结构体，可以用PrepareNamed生成命名预编译语句，不需要挨个罗列参数：

// 命名SQL用:字段名作为占位符
const insertUserNamedSQL = `INSERT INTO users (id, username, password, field3, field4, field5, field6, field7) 
VALUES (:id, :username, :password, :field3, :field4, :field5, :field6, :field7)`

var insertUserNamedStmt *sqlx.NamedStmt

func InitNamedPreparedStmts(db *sqlx.DB) error {
    var err error
    insertUserNamedStmt, err = db.PrepareNamed(insertUserNamedSQL)
    return err
}

func InsertUserDataNamed(ctx context.Context, u User) error {
    // 命名语句执行时，第二个参数直接传入绑定的结构体即可，sqlx会自动匹配字段取值
    _, err := insertUserNamedStmt.ExecContext(ctx, u)
    return err
}

注意：不要用context.WithValue传递SQL执行需要的业务参数，这是context的误用，会大幅降低代码可维护性，也不符合context的设计初衷。

内容的提问来源于stack exchange，提问作者Pygirl