ActiveAdmin复选框列表提交时出现空值的原因排查

问题原因 #

• 这是ActiveAdmin依赖的Formtastic表单库的默认行为：使用check_boxes类型时，会自动插入隐藏字段，确保未勾选任何选项时也能提交该字段的空值，避免因参数缺失导致模型字段不更新。
• include_hidden: false无效：这个参数仅适用于单个复选框（check_box），而非复选框列表（check_boxes），Formtastic的复选框列表输入不支持该参数。
• include_blank: false不对症：该参数是控制下拉选择框是否显示空选项的，对复选框列表完全不起作用。
• 嵌套表单的额外影响：你使用了listing_prices_attributes嵌套属性，Rails处理嵌套参数时会把隐藏字段的空值直接追加到weekdays数组中，而非覆盖为空数组，最终导致数组出现空字符串。

解决办法 #

1. 模型层过滤空值

在对应的嵌套模型（比如ListingPrice）中添加回调，自动清理空值：

before_validation :clean_weekdays

def clean_weekdays
  weekdays.reject!(&:blank?) if weekdays.present?
end

2. 控制器层处理参数

在ActiveAdmin的控制器中，处理参数时过滤掉空值：

permit_params :title, :description, listing_prices_attributes: [:id, :weekdays, :price, :_destroy]

def listing_params
  params.require(:listing).tap do |listing_params|
    if listing_params[:listing_prices_attributes].present?
      listing_params[:listing_prices_attributes].each do |price_attr|
        price_attr[:weekdays] = price_attr[:weekdays].reject(&:blank?) if price_attr[:weekdays].present?
      end
    end
  end.permit(permitted_params)
end

3. 前端JS移除隐藏字段

在ActiveAdmin的表单页面添加自定义JS，移除生成的隐藏字段：

document.addEventListener('DOMContentLoaded', function() {
  document.querySelectorAll('input[id*="_weekdays_none"]').forEach(element => element.remove());
});

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