Rails深层nested attributes表单添加地址后sub_address字段不显示问题

核心原因 #

不是JavaScript无法展示Rails渲染的内容，问题出在嵌套表单的关联对象没有预初始化：
Rails的fields_for方法默认只会在关联对象存在的时候才渲染对应的嵌套表单内容。首次加载页面时，你在Controller层已经为已有的address实例初始化了sub_address关联对象，所以内层表单正常显示。但在link_to_add_fields辅助方法中新建address实例时，没有预创建对应的sub_address关联对象，导致生成的模板HTML里本身就没有内层sub_address的表单内容，插入页面后自然不会显示。

具体修复步骤 #

1. 调整辅助方法，预构建关联对象 #

修改link_to_add_fields方法，为新建的address实例提前创建sub_address关联：

module Frontend::Data::DataHelper
def link_to_add_fields(name, form, association)
    new_object = form.object.send(association).klass.new
    # 新增下面这行，预构建关联对象，让fields_for可以渲染内层表单
    # 如果Address和SubAddress是has_one关联用这行
    new_object.build_sub_address 
    # 如果是has_many :sub_addresses关联，替换为下面这行
    # new_object.sub_addresses.build

    id = new_object.object_id
    fields = form.fields_for(association, new_object, child_index: id) do |builder|
        render(association.to_s.singularize + '_fields', form: builder)
    end

    link_to(name, '#', class: 'add_fields', data: {id: id, fields: fields.gsub('\n', '')})
end
end

2. 修正关联名匹配问题 #

检查你的父模型关联定义，确保视图里的关联名和模型定义一致：
如果父模型定义的是has_many :addresses，需要把视图代码调整为：

<div class="card-body">
    <%= form.fields_for :addresses do |addr| %>
        <%= render 'address_fields', form: addr %>
    <% end %>
    <%= link_to_add_fields 'Add Address', form, :addresses %>
</div>

同时保证address对应的局部模板文件名为address_fields.html.erb，和关联名单数形式匹配，避免渲染失败。

3. 可选：修复局部模板ID重复问题 #

你当前局部模板中写死了input的id属性，新增多个地址后会出现id重复，导致label点击失效，建议删除硬编码的id，让Rails自动生成：

<%= sub_addr.label :id_card, class: 'id-card-label' %>
<%= sub_addr.file_field :attachment_id_card %>

如果需要自定义id，可以拼接动态标识：

<% uid = form.object_id %>
<%= sub_addr.label :id_card, class: 'id-card-label', for: "id-card-file-#{uid}" %>
<%= sub_addr.file_field :attachment_id_card, id: "id-card-file-#{uid}" %>

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