本文介绍一种简洁可靠的方法，通过 PostgreSQL 的 array_to_json() 函数配合 Go 的 json.Unmarshal，将数据库返回的 character varying[] 等数组类型直接映射为 Go 原生 []string（或其他支持 JSON 序列化的切片类型）。
本文介绍一种简洁可靠的方法，通过 postgresql 的 `array_to_json()` 函数配合 go 的 `json.unmarshal`，将数据库返回的 `character varying[]` 等数组类型直接映射为 go 原生 `[]string`（或其他支持 json 序列化的切片类型）。
在使用 database/sql 驱动（如 lib/pq 或 pgx）访问 PostgreSQL 时，原生数组类型（如 text[]、varchar[]、integer[]）无法被 rows.Scan() 直接解码为 Go 切片。若尝试直接声明 var arr []string 并传入 Scan(&arr)，Go 会因类型不匹配而静默失败（例如长度为 0），且不报错——这是初学者常见的“零值陷阱”。
根本原因在于：PostgreSQL 数组在 wire protocol 层以自定义二进制/文本格式传输，而标准 database/sql 接口未内置对这类复合类型的解析逻辑。因此，需借助数据库端的标准化转换，再由 Go 端完成反序列化。
✅ 推荐方案：SQL 层转 JSON + Go 层反序列化
利用 PostgreSQL 内置函数 array_to_json() 将数组安全转换为标准 JSON 字符串（自动处理引号、转义、NULL 等边界情况），再在 Go 中用 json.Unmarshal 解析：
-- 示例查询：将字符串数组转为 JSON 字符串 SELECT array_to_json(urls) FROM posts WHERE id = 1; -- 返回示例：["http://wp.me/p62MJv-Jc","http://tyrant.click/1LGBoD6"]
对应 Go 代码如下：
import (
"database/sql"
"encoding/json"
"fmt"
)
// 假设 db 已初始化
rows, err := db.Query(`
SELECT array_to_json(tags)
FROM articles
WHERE status = $1`, "published")
if err != nil {
panic(err)
}
defer rows.Close()
for rows.Next() {
var jsonStr string
var tags []string // 支持任意 JSON 兼容类型：[]string, []int, []bool 等
if err := rows.Scan(&jsonStr); err != nil {
panic(err)
}
if err := json.Unmarshal([]byte(jsonStr), &tags); err != nil {
panic(fmt.Sprintf("failed to unmarshal JSON '%s': %v", jsonStr, err))
}
fmt.Printf("Found %d tags: %+v\n", len(tags), tags)
}⚠️ 注意事项与最佳实践：
-
空数组与 NULL 处理：array_to_json(NULL) 返回 null（JSON 字面量），此时 json.Unmarshal 会将 tags 置为 nil；若需统一为空切片，可添加判断：
if jsonStr == "null" { tags = []string{} } else { json.Unmarshal([]byte(jsonStr), &tags) } - 性能考量：该方法引入一次 JSON 编解码开销，但对绝大多数业务场景（单次查询 ≤ 数千元素）影响可忽略；如需极致性能，可考虑 pgx 驱动的原生 pgtype 扩展（需手动注册类型解析器）。
- 类型安全：确保 PostgreSQL 数组元素类型与 Go 切片元素类型语义一致（如 text[] ↔ []string，integer[] ↔ []int），否则 json.Unmarshal 会报错。
- 驱动兼容性：此方案适用于所有支持标准 SQL 的 PostgreSQL 驱动（lib/pq、pgx/v4 及 pgx/v5），无需额外依赖。
总结：与其陷入底层类型注册的复杂配置，不如采用“数据库标准化输出 + Go 通用解析”的组合策略——它简洁、可读性强、易于调试，且天然兼容各种数组嵌套结构（如 text[][] 可转为 [][]string）。这是生产环境中推荐的稳健实践。
