Rails表单取消选择collection_check_boxes时触发查询错误

问题根源 #

你遇到的ActiveRecord::RecordNotFound错误，是因为表单参数和模型配置冲突，导致Rails误将取消关联分类的操作当成了删除分类本身的请求。具体来说，大概率是启用accepts_nested_attributes_for :categories时打开了allow_destroy: true，同时表单参数混淆了「关联管理」和「分类实体管理」的逻辑。

原生Rails解决方案 #

1. 修正模型配置

在Post模型中，调整嵌套属性配置，只允许新增分类，禁止销毁分类实体（关联的增删通过category_ids处理）：

class Post < ApplicationRecord
  has_and_belongs_to_many :categories
  # 忽略空的新增分类字段，不允许销毁已有分类
  accepts_nested_attributes_for :categories, reject_if: :all_blank, allow_destroy: false
end

2. 调整强参数

确保控制器的强参数同时允许category_ids（处理已有分类的关联）和categories_attributes（处理新增分类），但不给categories_attributes开放_destroy权限：

class PostsController < ApplicationController
  # ... 其他方法

  private

  def post_params
    params.require(:post).permit(
      :title, :content, # 你的其他业务字段
      category_ids: [], # 允许传递分类ID数组，Rails自动处理关联增删
      categories_attributes: [:name] # 仅允许新增分类的name字段，无需id和_destroy
    )
  end
end

3. 优化表单逻辑

表单明确区分「选择已有分类」和「新增分类」模块，避免参数冲突：

<%= form_with model: @post do |f| %>
  <!-- 基础内容字段 -->
  <div>
    <%= f.label :title %>
    <%= f.text_field :title %>
  </div>

  <!-- 已有分类选择：用collection_check_boxes自动生成category_ids参数 -->
  <div>
    <%= f.label :category_ids, "选择已有分类" %>
    <%= f.collection_check_boxes :category_ids, Category.all, :id, :name do |cb| %>
      <%= cb.check_box %>
      <%= cb.label %>
    <% end %>
  </div>

  <!-- 新增分类：仅渲染未保存的新分类实例 -->
  <div>
    <%= f.fields_for :categories, Category.new do |category_form| %>
      <%= category_form.label :name, "新增分类名称" %>
      <%= category_form.text_field :name %>
    <% end %>
    <!-- 若需要动态新增多个分类字段，JS仅复制该fields_for块即可，保持参数格式正确 -->
  </div>

  <%= f.submit "保存" %>
<% end %>

4. 清理JS逻辑

确保你的JS仅负责动态添加/移除新增分类的字段，不要修改category_ids相关的复选框参数。Rails会自动处理category_ids数组：取消勾选分类时，该ID会从数组中移除，保存时Rails会自动删除对应关联记录，不会触及分类实体。

分类唯一验证调整 #

直接在Category模型中添加名称唯一验证即可，不影响关联操作：

class Category < ApplicationRecord
  has_and_belongs_to_many :posts
  validates :name, presence: true, uniqueness: true
end

调整后，取消选择已关联分类时，Rails仅删除posts_categories关联表中的对应记录，不会尝试删除Category实体，也不会出现找不到分类的错误。

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