Golang向含CTE的PostgreSQL查询传递切片作为数组参数时出现语法错误的原因排查

我来帮你排查这个问题，你遇到的语法错误主要是SQL语句对数组参数的处理方式不对，再加上参数传递的小细节没做好，咱们一步步来解决：

错误根源分析 #

1. SQL语句中ARRAY($2)的写法冗余且违反语法规范 #

你尝试用pg.Array(addresses)把Go切片转换成PostgreSQL的数组类型后，$2本身已经是一个合法的PostgreSQL数组对象了。这时候再用ARRAY($2)去包裹它，相当于让PostgreSQL“把一个数组再包装成数组”，这不符合PostgreSQL的语法逻辑，直接触发了at or near ")": syntax error的报错。

正确的做法是直接将数组参数传给UNNEST函数，不需要额外的ARRAY()包裹。

2. 参数传递需确保用驱动支持的方式包装切片 #

虽然你提到试过pg.Array，但要确认是否用对了对应驱动的包装方式：

• 如果用的是标准PostgreSQL驱动github.com/lib/pq，必须用pq.Array()来包装切片；
• 如果用的是pgx驱动，则需要用pgtype包下的对应数组类型（比如pgtype.TextArray）来包装。
  直接传递切片会被驱动识别为多个独立参数，导致SQL参数数量不匹配，也可能引发语法问题。

修正后的完整代码示例 #

用github.com/lib/pq驱动的情况 #

import (
    "context"
    "log"
    "database/sql"
    _ "github.com/lib/pq"
)

// ...

insertQuery = `
WITH cte AS (
    SELECT $1 AS id,
           UNNEST($2) AS address
)
INSERT INTO user_addresses
SELECT id, address
FROM cte;
`

addresses := []string{"firstAddress", "secondAddress", "thirdAddress"}
_, err := db.ExecContext(ctx, insertQuery, id, pq.Array(addresses))
if err != nil {
    log.Println(err)
}

用pgx驱动的情况 #

import (
    "context"
    "log"
    "github.com/jackc/pgx/v5"
    "github.com/jackc/pgx/v5/pgtype"
)

// ...

insertQuery = `
WITH cte AS (
    SELECT $1 AS id,
           UNNEST($2) AS address
)
INSERT INTO user_addresses
SELECT id, address
FROM cte;
`

addresses := []string{"firstAddress", "secondAddress", "thirdAddress"}
arrayParam := pgtype.TextArray{
    Elements: addresses,
    Status:   pgtype.Present,
}
_, err := db.ExecContext(ctx, insertQuery, id, arrayParam)
if err != nil {
    log.Println(err)
}

这样修改后，驱动会正确将Go切片转换成PostgreSQL数组，SQL语句也能正常解析UNNEST($2)并展开数组元素，插入到user_addresses表中。

备注：内容来源于stack exchange，提问作者vovanchello