Go 使用 database/sql 驱动查询 PostgreSQL UUID 数组时，默认将数组底层字节流（[]uint8）误判为二进制数据，导致 Scan 报错“unsupported Scan”。解决方案是使用 unnest() 展开数组逐行扫描，或升级至 pgx 驱动原生支持数组类型。
go 使用 database/sql 驱动查询 postgresql uuid 数组时，默认将数组底层字节流（[]uint8）误判为二进制数据，导致 scan 报错“unsupported scan”。解决方案是使用 `unnest()` 展开数组逐行扫描，或升级至 pgx 驱动原生支持数组类型。
PostgreSQL 原生支持数组类型（如 UUID[]），但标准 database/sql 接口及其常用驱动（如 lib/pq）不直接支持对 SQL 数组字段的结构化扫描。当执行 SELECT lists FROM users... 时，lists 是一个数组列，其 wire 协议表示为二进制格式的 []uint8，而 Go 的 sql.Scanner 无法自动将其转换为 []string 或 []uuid.UUID —— 这正是报错 unsupported Scan, storing driver.Value type []uint8 into type *[]string 的根本原因。
✅ 推荐方案：使用 unnest() 展开数组（兼容性最佳）
最简洁、无需更换驱动的解决方式是改写 SQL，利用 PostgreSQL 内置函数 unnest() 将数组“炸开”为多行结果集，再逐行扫描单个 UUID 字符串：
func FetchListIdsForUser(id string, db *sql.DB) ([]string, error) {
// 直接使用 db.Query（自动 prepare + cache），避免冗余 stmt 管理
rows, err := db.Query("SELECT unnest(lists) FROM users WHERE object_id = $1", id)
if err != nil {
return nil, fmt.Errorf("FetchListIdsForUser SQL Query: %w", err)
}
defer rows.Close()
var lists []string
for rows.Next() {
var list string // 注意：此处 scan 单个 string，非 *[]string
if err := rows.Scan(&list); err != nil {
return nil, fmt.Errorf("FetchListIdsForUser SQL Scan: %w", err)
}
lists = append(lists, list)
}
if err := rows.Err(); err != nil {
return nil, fmt.Errorf("FetchListIdsForUser row iteration error: %w", err)
}
// 若未返回任何行，说明用户不存在或 lists 为空/NULL
if len(lists) == 0 {
return nil, fmt.Errorf("FetchListIdsForUser: %s Does Not Exist or has empty lists", id)
}
return lists, nil
}
? 关键点说明：
- SELECT unnest(lists) 将 UUID[] 列转为零到多行的 UUID（自动转为字符串格式），每行对应数组中一个元素；
- rows.Scan(&list) 此时扫描的是单个 string，完全匹配 PostgreSQL 的 UUID 文本表示（如 "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"），不再触发类型不匹配；
- 移除了手动 Prepare/Close，db.Query 已内部优化并复用预编译语句，更安全简洁。
⚙️ 进阶方案：使用 pgx 驱动（原生数组支持）
若项目允许引入新依赖，pgx（v4+）提供了对 PostgreSQL 数组的一级原生支持，可直接扫描 []string 或 []pgtype.UUID：
import "github.com/jackc/pgx/v5"
// 使用 pgx.Conn（非 *sql.DB）
func FetchListIdsWithPgx(id string, conn *pgx.Conn) ([]string, error) {
var lists []string
err := conn.QueryRow("SELECT lists FROM users WHERE object_id = $1", id).Scan(&lists)
if err != nil {
if errors.Is(err, pgx.ErrNoRows) {
return nil, fmt.Errorf("user %s not found", id)
}
return nil, fmt.Errorf("scan failed: %w", err)
}
return lists, nil
}
✅ 优势：代码更直观、性能略优（避免 unnest 开销）、支持 NULL 数组、类型安全；
⚠️ 注意：需确保数据库字段定义为 UUID[] 且 pgx 版本 ≥ v4，并配置正确的 pgtype 注册（通常默认已支持）。
? 总结与建议
| 方案 | 适用场景 | 维护成本 | 类型安全 |
|---|---|---|---|
| unnest() + database/sql | 快速修复、最小改动、兼容所有驱动 | 极低 | ✅（字符串级） |
| pgx 原生扫描 | 新项目、长期维护、需强类型/高性能 | 中（引入新依赖） | ✅✅（支持 []uuid.UUID 等） |
不推荐重构数据库：PostgreSQL 的 UUID[] 是合理且高效的设计（相比关联表或 JSONB），问题根源在于 Go 驱动层抽象缺失，而非模型缺陷。优先选择上述任一扫描层适配方案即可稳健解决。
