Rails表单助手未生成正确子哈希的原因排查

问题背景 #

我有一个用于创建BookingAccommodation模型实例的表单，该模型属于Accommodation模型，包含internal_name属性。当前表单生成的input标签name为internal_name，但实际需要的是booking_accommodation[internal_name]，否则控制器中params.require(:booking_accommodation)会报错，无法获取嵌套参数。

相关代码 #

表单代码

<%= form_with model: @booking_accommodation, url: property_settings_accommodations_type_booking_accommodations_path(@accommodation) do |f| %>
    <div class="flex flex-col">
        <%= f.label :internal_name %>
        <%= f.text_field :internal_name, class: "border" %>
    </div>
    
    <div>
        <%= f.submit %>
    </div>
<% end %>

控制器代码

class Property::Settings::Accommodations::BookingAccommodationsController < PropertyController
    def create
        @accommodation = Accommodation.find(params[:type_id])
        @booking_accommodation = @accommodation.booking_accommodations.new(booking_accommodation_params)

        if @booking_accommodation.save
            redirect_to edit_property_settings_accommodations_type_path(@accommodation)
        else
            # Handle error
        end
    end
    
    private

    def booking_accommodation_params
        params.require(:booking_accommodation).permit(:internal_name)
    end
end

当前生成的HTML

<input class="border" type="text" name="internal_name" id="internal_name">

期望生成的HTML

<input class="border" type="text" name="booking_accommodation[internal_name]" id="internal_name">

原因分析 #

核心问题出在渲染表单时@booking_accommodation实例的初始化方式：

• 如果在渲染表单的action（比如new）中，你没有通过@accommodation.booking_accommodations.new来初始化@booking_accommodation，而是直接用BookingAccommodation.new，甚至根本没有初始化这个实例，Rails的form_with无法识别该实例的关联上下文和模型命名空间，因此不会自动添加booking_accommodation作为参数前缀。
• 另外，如果@booking_accommodation是已保存实例但关联关系未正确设置，也可能出现该问题，但你的场景是创建新实例，所以重点在初始化步骤。

解决方案 #

方法1：正确初始化表单实例（推荐） #

在对应的控制器中添加new action，通过关联对象初始化@booking_accommodation：

class Property::Settings::Accommodations::BookingAccommodationsController < PropertyController
    # 添加new action用于渲染表单
    def new
        @accommodation = Accommodation.find(params[:type_id])
        @booking_accommodation = @accommodation.booking_accommodations.new
    end

    def create
        # 原create代码不变
    end
    
    private
    # 原私有方法不变
end

这样初始化后，form_with会识别到该实例属于Accommodation的关联，自动为表单字段添加booking_accommodation[xxx]的name属性。

方法2：手动指定表单scope（备选） #

如果无法通过关联初始化实例，可以手动给form_with添加scope参数强制指定前缀：

<%= form_with model: @booking_accommodation, scope: :booking_accommodation, url: property_settings_accommodations_type_booking_accommodations_path(@accommodation) do |f| %>
    # 表单内容不变
<% end %>

这种方式会直接强制生成带booking_accommodation前缀的参数name，但不如第一种方法符合Rails的约定。

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