如何使用Ransack搜索belongs_to多层关联的模型属性

正确写法 #

你之前的写法有两处问题：一是Ruby语法不支持p.eq这种形式的Symbol键，二是多级关联需要嵌套对应层级的哈希结构，有两种可直接使用的实现方式：

方式1：嵌套哈希写法 #

# 示例为查询关联P模型的id等于1的A记录
A.ransack(b: { p: { id_eq: 1 } })

如果需要查询P模型的其他属性，替换id_eq即可，比如查询P的name字段等于"测试"：

A.ransack(b: { p: { name_eq: "测试" } })

方式2：关联路径下划线拼接写法（更常用） #

将多级关联名用下划线拼接后，加上属性名和查询谓词作为键即可：

# 等价于上面的id等于1查询
A.ransack(b_p_id_eq: 1)

# 等价于上面的name等于测试查询
A.ransack(b_p_name_eq: "测试")

常用查询谓词说明：eq=等于、cont=包含关键字、gteq=大于等于、lteq=小于等于、start=以指定内容开头，可根据实际查询需求替换对应谓词即可。

常见不生效原因排查 #

如果配置了正确的查询语法依然不生效，大概率是Ransack白名单限制导致：Ransack 4.0+版本默认开启关联与属性白名单，未加入白名单的关联和属性无法被搜索，需要在对应模型中添加白名单配置：

1. 在A模型中添加允许搜索的关联配置：

class A < ApplicationRecord
  belongs_to :b

  # 允许ransack搜索b关联
  def self.ransackable_associations(auth_object = nil)
    ["b"]
  end

  # 继承B模型的可搜索属性，不需要额外逐个添加
  def self.ransackable_attributes(auth_object = nil)
    super + B.ransackable_attributes(auth_object)
  end
end

2. 在B模型中添加允许搜索的关联配置：

class B < ApplicationRecord
  belongs_to :p
  has_many :a

  # 允许ransack搜索p关联
  def self.ransackable_associations(auth_object = nil)
    ["p"]
  end

  # 继承P模型的可搜索属性
  def self.ransackable_attributes(auth_object = nil)
    super + P.ransackable_attributes(auth_object)
  end
end

3. 在P模型中配置允许搜索的属性即可，比如允许搜索id和name：

class P < ApplicationRecord
  has_many :b

  def self.ransackable_attributes(auth_object = nil)
    %w[id name 其他需要搜索的属性名]
  end
end

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