使用GORM对PostgreSQL的JSONB列执行IN/包含查询的实现方法

你遇到的语法错误核心原因是 GORM的预编译参数占位符?和PostgreSQL JSONB类型的?存在运算符语义冲突，GORM在预处理SQL的时候会把你期望作为JSONB运算符的?识别成参数位，把后续参数错误替换到运算符的位置，最终生成非法SQL触发42601语法错误。

1. 单元素包含查询（匹配JSONB数组中存在指定值） #

推荐用无冲突的@>包含运算符实现，不需要处理转义，写法最简单：

方式1：直接传序列化后的JSON #

var res []switches
err := db.Where("switch_attrs @> ?", []byte(`{"IDs": ["2"]}`)).Find(&res).Error

方式2：传map自动序列化 #

GORM会自动将map结构序列化为JSONB类型参数：

queryCond := map[string]interface{}{
    "IDs": []string{"2"},
}
err := db.Where("switch_attrs @> ?", queryCond).Find(&res).Error

2. 多元素任意匹配（匹配数组包含指定列表中任意一个值） #

使用PostgreSQL内置的jsonb_exists_any函数替代?|运算符，完全规避占位符冲突，需要配合pq.Array转换Go切片为PostgreSQL数组类型：

注意需要提前导入github.com/lib/pq依赖包

targetIDs := []string{"2", "11"}
err := db.Where("jsonb_exists_any(switch_attrs->'IDs', ?)", pq.Array(targetIDs)).Find(&res).Error

3. 多元素全匹配（匹配数组包含指定列表中所有值） #

如果需要数组同时包含所有传入的目标值，使用jsonb_exists_all函数即可：

targetIDs := []string{"2", "11"}
err := db.Where("jsonb_exists_all(switch_attrs->'IDs', ?)", pq.Array(targetIDs)).Find(&res).Error

• 注意模型字段gorm:"column:xx"的列名配置必须和实际数据库表的列名完全一致，PostgreSQL默认对未加双引号的标识符自动转小写，如果你的表列名是switch_attrs，需要确保tag中配置的column值匹配。
• 上述所有实现都不需要写完整原生SQL，符合GORM链式调用的使用习惯。

内容的提问来源于stack exchange，提问作者Alok Ranjan