Pop不支持PostgreSQL数组字段自动映射，需手动实现sql.Scanner和driver.Valuer接口，或绕过Pop用RawQuery处理；建表、索引、查询均需原生SQL。
Pop不直接支持PostgreSQL数组字段的自动扫描
Buffalo默认搭配的ORM是Pop，但它对PostgreSQL原生数组类型（如text[]、integer[]）没有开箱即用的结构体字段映射能力。直接在model struct里声明[]string或[]int会导致sql.Scan error: unsupported Scan, storing driver.Value type []uint8 into type *[]string这类错误。
- 根本原因是
Pop底层使用database/sql驱动，而PostgreSQL的数组在wire protocol中以字节序列（[]uint8）传输，不是标准Go切片 -
Pop的Find/All方法不会自动调用pq.Array或pgx的数组解析逻辑 - 即使你用
pgx作为驱动，Pop也未封装其Scan行为到模型层
手动处理数组字段：用driver.Valuer + sql.Scanner
最稳妥的方式是让模型字段实现driver.Valuer和sql.Scanner接口，把数组序列化/反序列化控制权收回来。
例如，对应数据库列tags text[]：
type Article struct {
ID int `json:"id" db:"id"`
Title string `json:"title" db:"title"`
Tags []string `json:"tags" db:"tags"`
}
func (a *Article) Scan(value interface{}) error {
if value == nil {
a.Tags = []string{}
return nil
}
bs, ok := value.([]byte)
if !ok {
return fmt.Errorf("cannot scan %T into []string", value)
}
// 使用pq解析PostgreSQL数组格式（注意：需import "github.com/lib/pq"）
arr, err := pq.Array(&a.Tags).Scan(bs)
if err != nil {
return err
}
return arr
}
func (a Article) Value() (driver.Value, error) {
return pq.Array(a.Tags).Value()
}
- 必须显式引入
github.com/lib/pq（即使你用pgx驱动，Pop仍依赖pq的Array工具函数） -
Scan里不能直接用json.Unmarshal——PostgreSQL数组不是JSON，而是类似"{go,web,framework}"的字符串格式 - 如果用
pgx驱动，确保database.yml中dialect设为postgres，且连接URL含sslmode=disable等必要参数
绕过Pop：用tx.QueryRow或tx.Select直连查询
当数组字段只在少数关键查询中出现，不想污染整个model时，跳过Pop的自动映射更轻量。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
例如获取带tags的单条记录：
var id int
var title string
var tagsRaw []byte // 先读原始字节
err := tx.QueryRow("SELECT id, title, tags FROM articles WHERE id = $1", 123).
Scan(&id, &title, &tagsRaw)
if err != nil {
return err
}
// 手动解析
tags, err := pq.ParseArray(string(tagsRaw), "text")
if err != nil {
return err
}
-
pq.ParseArray能正确处理NULL、空数组{}、带引号元素"a,b"等边界情况 - 避免在
Pop.Find后额外QueryRow——事务上下文可能丢失，应统一用tx对象 - 注意
tagsRaw可能是nil（对应SQLNULL），需先判空再转string
迁移时注意PostgreSQL数组的DDL写法
Pop的create_table迁移不识别array类型别名，必须手写SQL或用db.RawQuery。
- 建表时不能写
t.Column("tags", "array", {})——Pop会报错未知类型 - 正确做法是在migration文件中用
tx.RawQuery("ALTER TABLE articles ADD COLUMN tags text[]") - 若用
Pop.Migrate()，需在models/migrations/xxx_add_tags_to_articles.up.fizz里写原生SQL：alter_table("articles", func(t *fizz.Table) { t.Column("tags", "text[]") })（仅fizz支持此语法） - 数组索引要手动加：
CREATE INDEX idx_articles_tags ON articles USING GIN (tags)，Pop不生成GIN索引
数组字段的“透明性”是假象——Pop没把它当一等公民，所有操作都得你亲手托底。别指望Save自动处理，也别在Where条件里直接写tags = ?，PostgreSQL数组比较要用@>或ANY，这些都得进RawQuery。
