必须用pgtype.TextArray等专用类型或自定义Scanner/Valuer接口映射，否则GORM会将TEXT[]转为字符串"{a,b,c}"导致丢失原生数组操作能力；需配合ARRAY[?]语法或LATERAL unnest实现@>查询，批量更新须用Exec绕过ORM调用array_append等函数。
PostgreSQL数组字段在GORM中怎么映射才不丢数据
PostgreSQL的TEXT[]、INTEGER[]等数组类型不能直接用Go原生切片（如[]string）无损映射——GORM默认会把TEXT[]转成string，内容变成"{a,b,c}"这种字符串，后续无法用@>或ANY做原生数组操作。
必须显式声明为pgtype.TextArray或pgtype.Int4Array等PostgreSQL专用类型（需引入github.com/jackc/pgtype），或退而求其次用[]string配合gorm:"type:TEXT[]"并禁用零值覆盖：
-
Tags []string `gorm:"type:TEXT[];not null"`—— 仅当业务只做全量读写、不依赖数据库侧数组函数时可用 - 若需
@>判断包含、array_length统计长度、unnest展开等能力，必须用pgtype.TextArray，并在Scan/Value方法中手动实现序列化 - GORM v1.25+ 支持
scanner接口，可封装一个StringArray类型，内部用pgtype.TextArray处理，对外暴露[]string接口
用GORM查“数组包含某个值”必须绕开Where链式拼接
WHERE tags @> ARRAY['go']这类PostgreSQL特有语法，GORM的Where("tags @> ?", "{go}")会失败：参数被自动加引号变成'{go}'，而@>要求右侧是数组字面量或ARRAY[...]构造器。
正确做法只有两种：
- 用
Where("tags @> ARRAY[?]", "go")—— 注意ARRAY[?]里问号不能带引号，且仅支持单值；多值要写ARRAY[?, ?, ?]并传对应参数 - 更通用的是
Joins("CROSS JOIN LATERAL (SELECT * FROM unnest(tags) AS t(tag)) AS t")+Where("t.tag = ?", "go")，但性能差，仅用于复杂条件组合 - 绝对不要用
Where("tags && ARRAY[?]", "go")代替@>：前者是“交集非空”，后者才是“完全包含”，语义不同
Preload关联表时带数组字段，容易触发N+1和字段膨胀
假设User有Roles TEXT[]，Order属于User，你写db.Preload("User").Find(&orders)，GORM会生成两条SQL：SELECT * FROM orders和SELECT * FROM users WHERE id IN (…)。问题在于后者会把roles整个数组拉下来，即使订单列表接口根本不需要角色信息。
解决方案是字段级裁剪：
- 用
Preload("User", func(db *gorm.DB) *gorm.DB { return db.Select("id", "name", "roles") })，显式控制只加载必要字段 - 如果
roles很大（比如存了上百个权限字符串），且前端只要判断是否有某个角色，就改用子查询：db.Select("*, (SELECT COUNT(*) > 0 FROM users u WHERE u.id = orders.user_id AND u.roles @> ARRAY['admin']) AS is_admin") - 避免在模型里定义
Roles为[]string后又加gorm:"-"忽略——这样Preload时字段就彻底不可见，但Joins也拿不到，得不偿失
批量更新数组字段时，PostgreSQL的array_append不能直接用GORM的Update
db.Model(&user).Update("roles", "new_role")会把整个roles字段替换成字符串"new_role"，而不是追加。GORM不解析PostgreSQL的数组函数语义。
必须用Exec或Session绕过ORM层：
db.Exec("UPDATE users SET roles = array_append(roles, ?) WHERE id = ?", "editor", userID)- 或用
Clause注入：db.Session(&gorm.Session{DryRun: true}).Model(&User{}).Clauses(clause.Set{Expr: clause.Expr{SQL: "roles = array_append(roles, ?)", Vars: []interface{}{"editor"}}}).Where("id = ?", userID).Update("")（注意Update("")是占位用） - 删除元素同理，用
array_remove(roles, ?)，别试图用Replace或Map在内存里操作再全量写回——并发下极易丢失更新
数组字段的查询和更新，本质上是在用GORM“外壳”调用PostgreSQL“内核”。一旦涉及@>、array_append、unnest这些特性，就得接受部分逻辑必须下沉到SQL层——这不是GORM的缺陷，而是ORM与关系型数据库扩展能力之间的天然边界。
