Rails的collection_select为何无法渲染关联属性？

问题描述 #

模型关联关系：

• Flight 模型 belongs_to :departure_airport（关联 Airport 模型）
• Airport 模型 has_many :departing_flights（关联 Flight 模型）

尝试在 Rails 的 form_with 表单中创建下拉选择框，希望选项显示 Airport 的 :city 属性，但渲染后下拉选项仅显示 Airport 对象的引用字符串（如 #<Airport:0x00000001126f0730>），尝试 :departure_airport.name 写法也无效。

现有代码

视图表单（flight#index）

<%= form_with(url: flights_path, method: :get) do |form| %>
  <div>
    <%= form.label :departure_airport, 'Departure Airport' %>
    <%= form.collection_select :departure_airport, @flights, :departure_airport_id, :departure_airport.city, prompt: 'Select Departure Airport' %>    
  </div>
  <div>
    <%= form.submit 'Search Flights' %>
  </div>
<% end %>

Flight 控制器

class FlightsController < ApplicationController
  def index
    @flights = Flight.all
  end
end

Flight 模型

class Flight < ApplicationRecord
  belongs_to :departure_airport, class_name: 'Airport'
  validates_presence_of :departure_airport
end

Airport 模型

class Airport < ApplicationRecord
  has_many :departing_flights, class_name: 'Flight', foreign_key: 'departure_airport_id'
end

渲染后的 HTML 片段

<form action="/flights" accept-charset="UTF-8" method="get">
  <div>
    <label for="departure_airport">Departure Airport</label>
    <select name="departure_airport" id="departure_airport"><option value="">Select Departure Airport</option>
<option value="8">#&lt;Airport:0x00000001126f0730&gt;</option>
<option value="60">#&lt;Airport:0x0000000112728630&gt;</option>
<option value="47">#&lt;Airport:0x0000000112713140&gt;</option>
<option value="33">#&lt;Airport:0x00000001126fbdd8&gt;</option>
etc ...
<option value="42">#&lt;Airport:0x0000000112c9b568&gt;</option></select>    
  </div>
  <div>
    <input type="submit" name="commit" value="Search Flights" data-disable-with="Search Flights">
  </div>
</form>

错误原因 #

1. 数据源错误：collection_select 的第二个参数应该是要渲染为选项的 Airport 集合，而非 @flights（Flight 集合）。当前遍历 Flight 对象时，文本方法无法通过链式符号（:departure_airport.city）调用关联模型属性，Rails 的 collection_select 仅支持直接调用当前集合元素的方法。
2. 字段名不符合约定：表单字段名应使用 departure_airport_id，而非 departure_airport，这样提交后的参数更符合 Rails 数据处理的约定。

修正方案 #

1. 修改控制器

在 Flight 的 index 方法中，获取所有 Airport 对象作为下拉选项的数据源：

class FlightsController < ApplicationController
  def index
    @airports = Airport.all # 新增机场集合变量
    @flights = if params[:departure_airport_id].present?
                 # 可选：根据选择的机场筛选航班
                 Flight.where(departure_airport_id: params[:departure_airport_id])
               else
                 Flight.all
               end
  end
end

2. 修改表单的 collection_select

调整参数为正确的集合、值方法和文本方法：

<%= form_with(url: flights_path, method: :get) do |form| %>
  <div>
    <%= form.label :departure_airport_id, 'Departure Airport' %>
    <%= form.collection_select :departure_airport_id, @airports, :id, :city, prompt: 'Select Departure Airport' %>    
  </div>
  <div>
    <%= form.submit 'Search Flights' %>
  </div>
<% end %>

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