如何在Ruby on Rails中全局搜索Postgres JSON字段？

当然可以，针对无固定结构的JSON字段，有两种实用的搜索方式，具体如下：

方法一：将JSON转为字符串进行模糊搜索 #

这是最直接的方案，无需关心JSON内部结构，直接把JSON字段转成文本后用模糊匹配：

# 基础写法：匹配关键词（注意：若关键词含%/_需转义）
Model.where("data::text LIKE ?", "%#{keyword}%")

# 带转义的安全写法
escaped_keyword = keyword.gsub(/[%_]/, '\0')
Model.where("data::text LIKE ?", "%#{escaped_keyword}%")

# 不区分大小写的匹配（用ILIKE替代LIKE）
Model.where("data::text ILIKE ?", "%#{keyword}%")

这种方式的优点是简单高效，适合快速实现全局搜索；缺点是可能会误匹配JSON的语法字符（比如引号、冒号），但大部分场景下足以满足需求。

方法二：遍历JSON键值对进行精准搜索 #

如果需要只匹配JSON的键或值（而非JSON字符串中的任意位置），可以用Postgres的json_each_text函数拆分JSON结构，再针对性搜索：

# 搜索键或值中包含关键词的记录，自动去重
Model.joins("JOIN json_each_text(data) AS j ON true")
     .where("j.key LIKE ? OR j.value LIKE ?", "%#{keyword}%", "%#{keyword}%")
     .distinct

# 不区分大小写的版本
Model.joins("JOIN json_each_text(data) AS j ON true")
     .where("j.key ILIKE ? OR j.value ILIKE ?", "%#{keyword}%", "%#{keyword}%")
     .distinct

如果你的JSON字段是Postgres推荐的jsonb类型，写法完全一致，json_each_text同样支持。

注意事项 #

• 性能优化：如果数据量较大，上述两种方法都无法利用索引，搜索速度会变慢。若需频繁搜索，建议将JSON字段转为jsonb类型并创建GIN索引，或者把高频搜索的键单独提取为普通字段。
• SQL注入防护：务必对关键词中的特殊字符（%、_）进行转义，避免语法错误或注入风险。

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