本文介绍通过 array_to_json 函数配合 json 反序列化，将 postgresql 的 character varying[] 等数组类型安全、高效地映射为 go 原生 []string（或其他支持类型）的完整方案，并附可运行示例与关键注意事项。
本文介绍通过 array_to_json 函数配合 json 反序列化，将 postgresql 的 character varying[] 等数组类型安全、高效地映射为 go 原生 []string（或其他支持类型）的完整方案，并附可运行示例与关键注意事项。
在 Go 中使用 database/sql 驱动（如 pgx 或 pq）读取 PostgreSQL 的数组列（如 TEXT[]、VARCHAR[]）时，不能直接通过 rows.Scan(&slice) 赋值——因为标准驱动不支持自动解析 PostgreSQL 数组格式（如 {a,b,c}），导致目标切片保持零值（长度为 0）。这是开发者常遇到的“静默失败”问题。
最简洁、兼容性高且无需引入额外 ORM 的解决方案是：在 SQL 层将数组转为 JSON 字符串，再在 Go 层用 json.Unmarshal 解析为原生切片。PostgreSQL 内置函数 array_to_json() 正好满足这一需求，它能将任意维度数组（包括嵌套）转换为标准 JSON 格式（如 ["a","b","c"]），完全符合 Go 的 json 包解析规范。
✅ 推荐实现方式
-- 查询语句：将 PostgreSQL 数组列转为 JSON 字符串 SELECT array_to_json(urls) FROM posts WHERE id = $1;
import (
"database/sql"
"encoding/json"
"fmt"
_ "github.com/lib/pq" // 或 github.com/jackc/pgx/v5
)
var arrStr string
var urls []string
err := db.QueryRow("SELECT array_to_json(urls) FROM posts WHERE id = $1", 123).Scan(&arrStr)
if err != nil {
log.Fatal(err)
}
if err := json.Unmarshal([]byte(arrStr), &urls); err != nil {
log.Fatal("JSON 解析失败:", err)
}
fmt.Printf("共 %d 个 URL: %+v\n", len(urls), urls)
// 输出示例：共 2 个 URL: [http://wp.me/p62MJv-Jc http://tyrant.click/1LGBoD6]⚠️ 关键注意事项
-
空数组与 NULL 处理：若数据库中该数组列为 NULL，array_to_json() 返回 null（JSON 字符串 "null"），此时 json.Unmarshal 会将 []string 设为 nil（长度为 0）。建议显式检查：
if arrStr == "null" { urls = []string{} // 或跳过处理 } - 类型一致性：确保 PostgreSQL 数组元素类型与 Go 切片元素类型兼容（如 TEXT[] → []string，INTEGER[] → []int）。混合类型或非法 JSON 将导致 Unmarshal 报错。
- 性能考量：对于高频查询，该方案增加了一次字符串转换与 JSON 解析开销，但远低于手动解析 {a,b,c} 格式的复杂度与出错风险；如极致性能敏感，可考虑 pgx 驱动的原生 pgtype.TextArray 类型（需额外配置）。
- 驱动兼容性：该方法适用于所有支持标准 database/sql 接口的 PostgreSQL 驱动（pq、pgx、pgxpool），无需修改连接配置。
✅ 总结
用 array_to_json() + json.Unmarshal 是目前 Go 生态中最轻量、最可靠、最易维护的 PostgreSQL 数组解析模式。它规避了底层二进制协议解析的复杂性，利用成熟稳定的 JSON 工具链，兼顾可读性与健壮性。只要 SQL 层做一次函数封装，Go 层即可获得地道的 slice 类型，真正实现“所见即所得”的数据映射。
