使用Golang Squirrel构建INSERT语句时pgx报语法错误排查

核心问题1：占位符不兼容 #

squirrel默认生成的SQL使用?作为参数占位符，但pgx遵循PostgreSQL规范，采用$1、$2这类位置占位符。这就是为什么你在Goland控制台直接执行SQL能成功，但代码中用pgx执行会报语法错误的根本原因——pgx无法解析?占位符，导致SQL语法校验失败。

解决：初始化squirrel时指定PostgreSQL格式的占位符，使用sq.StatementBuilder.PlaceholderFormat(sq.Dollar)。

核心问题2：批量插入的Values构造逻辑 #

你当前用Values(as[0].Name).Values(as[1].Name)生成的SQL语法本身没问题，但结合占位符修复后，需要确保参数传递与占位符一一对应。更简洁的写法是通过循环为每个元素添加行数据。

核心问题3：QueryRow与Scan的误用 #

批量插入会返回多个id，QueryRow仅能处理单行结果，必须改用Query获取多行结果。同时，你不能直接将切片&as传给Scan，需要逐个扫描结果到切片的每个结构体元素中。

修正后的完整代码 #

package main

import (
    "context"
    "fmt"
    sq "github.com/Masterminds/squirrel"
    "github.com/jackc/pgx/v5/pgxpool"
)

func main() {
    dsn := "postgresql://user:password@localhost:5432/merge?sslmode=disable"
    ctx := context.Background()
    pool, err := pgxpool.New(ctx, dsn)
    if err != nil {
        panic(err)
    }
    defer pool.Close() // 避免连接池资源泄漏

    type a struct {
        ID   uint
        Name string
    }

    as := []a{{
        Name: "asd",
    }, {
        Name: "zxc",
    }}

    // 初始化适配PostgreSQL占位符的SQL构建器
    psqlBuilder := sq.StatementBuilder.PlaceholderFormat(sq.Dollar)

    // 构造批量插入语句
    insertStmt := psqlBuilder.Insert("collections").Columns("name")
    for _, item := range as {
        insertStmt = insertStmt.Values(item.Name)
    }
    insertStmt = insertStmt.Suffix("RETURNING id")

    query, args, err := insertStmt.ToSql()
    if err != nil {
        panic(err)
    }

    // 用Query获取多行返回结果
    rows, err := pool.Query(ctx, query, args...)
    if err != nil {
        panic(err)
    }
    defer rows.Close()

    // 逐个扫描返回的id到对应结构体中
    idx := 0
    for rows.Next() {
        if idx >= len(as) {
            break // 防止索引越界
        }
        err := rows.Scan(&as[idx].ID)
        if err != nil {
            panic(err)
        }
        idx++
    }
    // 检查遍历rows过程中是否出现错误
    if err := rows.Err(); err != nil {
        panic(err)
    }

    fmt.Printf("%v", as)
}

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