Rails 6.1结合Bootstrap5实现嵌套表单仅保存关联ID问题排查

根本原因 #

该问题和Bootstrap本身无任何兼容性关联，两处代码逻辑错误导致字段无法正常存储：

1. 表单模板中fields_for调用时重复执行@client.shipping_addresses.build，生成的嵌套字段参数名不符合Rails嵌套属性规范，提交的地址参数无法被正确识别。
2. 客户控制器create动作中存在冗余的build逻辑，手动构建的地址对象覆盖了参数中携带的地址字段值，最终仅保存了关联外键。

修复步骤 #

1. 修正客户视图表单局部模板 #

将fields_for的入参从手动build的地址对象改为关联名:shipping_addresses，直接读取new动作中预构建的地址对象生成表单字段，同时可以直接添加Bootstrap表单类适配样式，嵌套逻辑和Bootstrap样式无任何冲突：

<%= form_with(model: client) do |form| %>
   <% if client.errors.any? %>
     <div id="error_explanation" class="alert alert-danger">
       <h2><%= pluralize(client.errors.count, "error") %> 禁止该客户保存：</h2>
       <ul>
         <% client.errors.each do |error| %>
           <li><%= error.full_message %></li>
         <% end %>
       </ul>
     </div>
   <% end %>

   <div class="mb-3">
     <%= form.label :client_name, class: "form-label" %>
     <%= form.text_field :client_name, class: "form-control" %>
   </div>

   <%# 替换原有错误的fields_for写法，不要在这里执行build %>
   <%= form.fields_for :shipping_addresses do |s| %>
     <div class="mb-3">
       <%= s.label :address_line1, '地址行1', class: "form-label" %>
       <%= s.text_field :address_line1, class: "form-control" %>
     </div>

     <div class="mb-3">
       <%= s.label :address_line2, '地址行2', class: "form-label" %>
       <%= s.text_field :address_line2, class: "form-control" %>
     </div>

     <div class="mb-3">
       <%= s.label :city, '城市', class: "form-label" %>
       <%= s.text_field :city, class: "form-control" %>
     </div>

     <div class="mb-3">
       <%= s.label :state, '省份/州', class: "form-label" %>
       <%= s.text_field :state, class: "form-control" %>
     </div>

     <div class="mb-3">
       <%= s.label :country, '国家', class: "form-label" %>
       <%= s.text_field :country, class: "form-control" %>
     </div>
   <% end %>

   <div class="actions">
     <%= form.submit class: "btn btn-primary" %>
   </div>
<% end %>

2. 移除客户控制器create动作的冗余代码 #

使用accepts_nested_attributes_for后，Rails会自动根据强参数中的嵌套属性创建关联对象，不需要手动重复构建地址：

def create
  # 删除原有的两行冗余build和save代码
  @client = Client.new(client_params)

  respond_to do |format|
    if @client.save
      format.html { redirect_to @client, notice: "客户创建成功" }
      format.json { render :show, status: :created, location: @client }
    else
      format.html { render :new, status: :unprocessable_entity }
      format.json { render json: @client.errors, status: :unprocessable_entity }
    end
  end
end

3. 可选优化（提升扩展性） #

如果后续需要支持删除嵌套的收货地址，可做如下调整：

• 客户模型添加允许销毁嵌套属性的配置：

  accepts_nested_attributes_for :shipping_addresses, allow_destroy: true
  

• 客户强参数中添加_destroy字段：

  def client_params
    params.require(:client).permit(:client_name, shipping_addresses_attributes: [:id, :address_line1, :address_line2, :city, :state, :country, :_destroy])
  end
  

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