PostgreSQL 文本数组字段插入：Go 中动态构建合法数组字符串

本文详解如何在 go 应用中将用户输入的字符串切片（如文章标签）安全、正确地序列化为 postgresql 兼容的 `text[]` 数组字符串格式，避免 `pq: array value must start with “{“` 等常见解析错误。

在 PostgreSQL 中，TEXT[] 类型字段（如 tags character varying(255)[]）接受两种主流输入格式：字面量数组语法（如 {“apple”,”orange”}）或 ARRAY[…] 构造器语法（如 ARRAY[‘apple’, ‘orange’]）。但 database/sql 及 sqlx 驱动默认仅支持前者作为字符串值传入——这意味着你必须手动构造符合 PostgreSQL 数组文本协议的字符串，而不能直接传递 Go 的 []string。

关键在于：PostgreSQL 要求数组字符串必须以 {开头、} 结尾，元素用英文逗号分隔，且每个元素必须是 带双引号的合法字符串字面量（尤其当元素含空格、逗号、反斜杠或 Unicode 时）。fmt.Sprintf(“%q”, …) 无法直接用于切片，需逐个转义并拼接。

以下为推荐实现（使用 strconv.Quote 安全转义）：

import ("strings"     "strconv")  func buildPGTextArray(tags string) string {if tags == ""{         return"{}"}     parts := strings.Split(tags,",")     for i, s := range parts {// 去除首尾空格，再转义为 PostgreSQL 兼容的带引号字符串         trimmed := strings.TrimSpace(s)         parts[i] = strconv.Quote(trimmed)     }     return"{"+ strings.Join(parts,",") +"}"}  // 使用示例 tagsInput := r.FormValue("tags") // e.g.,"golang, web, postgres"t := Article{Body:"this is a post",     Tags: buildPGTextArray(tagsInput), // → {"golang","web","postgres"} }

⚠️ 注意事项：

• 不要使用 fmt.Sprintf(“%q”, slice)：它会输出 Go 语法格式（如 []string{“a”,”b”}），非 PostgreSQL 所需；
• 避免手动拼接引号：若标签含 ” 或，直接加引号会导致 SQL 解析失败，strconv.Quote 自动处理转义；
• 空输入处理：传入空字符串或空切片时应返回 “{}”，而非 nil 或空字符串，否则触发 pq: missing dimension value；
• SQL 注入风险低但非零：此方式本质是字符串拼接，虽经 strconv.Quote 转义已覆盖绝大多数边界字符，但仍建议前端做基础校验（如限制标签长度、禁止控制字符）；
• 更优替代方案（进阶）：若使用 pgx 驱动，可直接传递 []string 并启用 pgtype 支持，由驱动自动序列化；但 sqlx + pq 组合下，手动构造仍是标准解法。

最终，你的 Insert 方法无需修改——只要确保 t.Tags 是格式正确的数组字符串（如 {“go”,”sql”,”api”}），PostgreSQL 即可正确解析并存入 TEXT[] 字段。