如何在 Go 中直接将 PostgreSQL 数组列解码为 []string

本文介绍一种简洁可靠的方法，通过 PostgreSQL 的 array_to_json() 函数配合 Go 的 json.Unmarshal，将 character varying[] 等数组类型安全、无损地转换为原生 Go 切片（如 []string），避免手动解析或第三方驱动扩展。

本文介绍一种简洁可靠的方法，通过 postgresql 的 `array_to_json()` 函数配合 go 的 `json.unmarshal`，将 `character varying[]` 等数组类型安全、无损地转换为原生 go 切片（如 `[]string`），避免手动解析或第三方驱动扩展。

在使用 database/sql 驱动（如 pgx 或标准 pq）查询 PostgreSQL 时，原生数组类型（如 TEXT[]、VARCHAR[]）无法被 Go 的 rows.Scan() 直接解码为 []string——这是由 SQL 驱动层对 PostgreSQL 数组的默认处理机制决定的：它通常返回 []byte 形式的内部文本表示（如 "{a,b,c}"），而 Go 标准库不提供自动解析逻辑，导致 Scan(&arr) 后 len(arr) 恒为 0。

✅ 推荐方案：利用 PostgreSQL 内置函数 array_to_json() 将数组转为标准 JSON 字符串，再在 Go 层统一反序列化：

SELECT array_to_json(urls) FROM posts WHERE id = 1;
-- 返回示例: ["http://wp.me/p62MJv-Jc", "http://tyrant.click/1LGBoD6"]

对应 Go 代码如下：

音刻

AI音视频转录和笔记工具

下载

var arrStr string
var urls []string

rows, err := db.Query("SELECT array_to_json(urls) FROM posts WHERE active = true")
if err != nil {
    log.Fatal(err)
}
defer rows.Close()

for rows.Next() {
    if err := rows.Scan(&arrStr); err != nil {
        log.Printf("scan error: %v", err)
        continue
    }
    if err := json.Unmarshal([]byte(arrStr), &urls); err != nil {
        log.Printf("json unmarshal error: %v (raw: %q)", err, arrStr)
        continue
    }
    fmt.Printf("Found %d URLs: %+v\n", len(urls), urls)
}

⚠️ 注意事项：

• array_to_json() 对 NULL 数组返回 null（JSON null），此时 json.Unmarshal 会将 urls 置为 nil；若需区分空数组 [] 与 NULL，可先检查 arrStr == "null"。
• 所有元素类型需与目标 Go 类型兼容（如 TEXT[] → []string，INT[] → []int），否则 Unmarshal 会报错。
• 不依赖 pgx 的高级类型支持（如 pgtype.TextArray），兼容标准 pq 驱动，适合轻量级项目或迁移场景。
• 若需高性能大批量处理，可考虑 pgx 的原生数组支持（pgx.QueryRow().Scan(&pgtype.TextArray{Elements: ...})），但本方案胜在简洁、可移植、零额外依赖。

总结：无需引入复杂 ORM 或驱动扩展，仅靠一条 SQL 函数 + 一行 json.Unmarshal，即可实现 PostgreSQL 数组到 Go 切片的健壮映射。这是兼顾可读性、兼容性与维护性的生产就绪实践。