如何在Rails ActiveRecord中查询MySQL JSON字段的精确匹配哈希值

适用版本要求 #

• MySQL 5.7 及以上（支持JSON操作函数）
• Rails 5 及以上（原生支持JSON字段相关操作）

场景1：JSON字段至少包含传入的所有键值对（允许存在额外键） #

这也是你问题中描述的需求：只要JSON字段覆盖传入哈希的全部键、且对应值完全一致就返回，忽略键顺序、允许JSON字段有其他额外键。
MySQL内置的JSON_CONTAINS函数刚好满足该需求，你可以在Model中封装一个scope简化调用：

class Link < ApplicationRecord
  # json_fields为你存储JSON数据的字段名，可根据实际情况修改
  scope :match_json_fields, ->(query_hash) {
    where("JSON_CONTAINS(json_fields, ?)", JSON.generate(query_hash))
  }
end

调用方式和你预期的形式基本一致：

# 传入任意顺序的查询哈希即可
Link.match_json_fields({
  city_eq: "NewYork",
  rent_true: false,
  estate_type_eq: 0
})

场景2：JSON字段和传入哈希完全相等（不允许存在额外键） #

如果要求JSON字段不能有查询哈希之外的其他键，可以做双向包含校验，确保两个JSON结构完全一致：

class Link < ApplicationRecord
  scope :exact_match_json_fields, ->(query_hash) {
    json_str = JSON.generate(query_hash)
    where("JSON_CONTAINS(json_fields, ?) AND JSON_CONTAINS(?, json_fields)", json_str, json_str)
  }
end

Rails 7+ 简化写法 #

如果你使用Rails 7及以上版本，框架已经原生适配了MySQL JSON字段的包含查询，你问题中写的调用形式可以直接生效：

Link.where(json_fields: {
  city_eq: "NewYork",
  rent_true: false,
  estate_type_eq: 0
})

注意事项 #

• JSON_CONTAINS的匹配是严格类型校验：比如数字0和字符串"0"、布尔值false和字符串"false"都会被判定为不相等，符合你要求的完全匹配规则
• 查询频率较高的场景建议给JSON字段创建专门的JSON索引，或者给常用查询键创建虚拟列加普通索引，可大幅提升查询性能

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