ActiveAdmin含Nil值布尔字段筛选Null选项不生效问题

问题根因 #

默认Rails参数解析层会自动丢弃值为nil的表单提交参数，同时Ransack默认的in查询谓词不会对空值做特殊处理，导致原配置中选择Null选项提交时，后端根本收不到对应筛选参数，直接返回无筛选状态。
拆分三个独立布尔筛选器的方案交互割裂，无法实现单组复选框多选组合查询的需求，不推荐使用。

实现步骤 #

1. 模型层添加自定义Ransack查询scope #

在app/models/guest.rb中添加自定义查询逻辑，支持同时匹配布尔值与nil值：

class Guest < ApplicationRecord
  # 原有模型关联、校验等代码保持不变

  # 自定义三态参与状态查询scope
  scope :ransack_participate_in, ->(raw_values) {
    # 转换前端传的字符串参数为对应布尔/nil类型
    normalized_values = raw_values.map do |val|
      case val
      when "true" then true
      when "false" then false
      when "nil" then nil
      end
    end.uniq

    has_nil = normalized_values.include?(nil)
    bool_values = normalized_values.compact

    relation = all
    if has_nil && bool_values.present?
      relation = relation.where(participate: bool_values).or(where(participate: nil))
    elsif has_nil
      relation = relation.where(participate: nil)
    elsif bool_values.present?
      relation = relation.where(participate: bool_values)
    end
    relation
  }

  # 注册scope允许Ransack调用
  def self.ransackable_scopes(_auth = nil)
    [:ransack_participate_in]
  end
end

2. 修改ActiveAdmin配置 #

替换原有的participate筛选器配置，使用自定义scope实现单组复选框，将nil选项的值替换为字符串"nil"避免被参数层过滤：

ActiveAdmin.register Guest do
  permit_params :user_id, :participate, :name

  index do
    selectable_column
    column :id
    column :user, sortable: :user_id
    column :participate do |guest|
      if guest.participate
        "Yes"
      elsif guest.participate.nil?
        "Null"
      else
        "No"
      end
    end
    actions
  end

  # 三态状态筛选器
  filter :ransack_participate_in,
         as: :check_boxes,
         label: "参与状态",
         collection: [["Yes", "true"], ["No", "false"], ["Null", "nil"]]
end

效果说明 #

• 保留单组复选框的原生交互，支持任意状态组合多选查询，和ActiveAdmin默认筛选器体验完全一致
• 不会出现选Null值无响应的问题，筛选条件会正常显示在页面顶部的当前筛选栏中
• 不需要引入额外gem，兼容Rails 6+、ActiveAdmin 2.x+、Ransack 2.x+以上版本

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