Rails集成Select2、Ransack查询城市关联街道返回空数组问题
现存代码的核心问题
- 接口职责错位:
search_city方法的设计初衷是为Select2输入提供城市名称联想候选,内部逻辑是用输入的文本匹配城市名称字段返回候选列表。但现在搜索表单的提交地址直接指向了这个接口,当用户选中具体城市提交时,传的参数是数字格式的geo_code值,这个值会被传入city.first.include?的判断逻辑里——也就是拿纯数字去匹配城市名称字段,自然匹配不到任何结果,最终返回空数组。 - 控制器方法空值风险:原
filter方法中,查询@city的逻辑只有在携带geo_code参数时才会执行,首次进入页面或者参数缺失时@city为nil,后续执行@city.streets会直接抛出空对象错误,没法正常加载初始街道数据。 - 视图配置参数错误:Haml里的
options_for_select调用把选项数组嵌套在collection键里,这个方法不识别这种嵌套结构,会导致下拉选项渲染失效,连带Select2的选中值无法正常回填。 - 流程链路断裂:街道搜索的结果渲染逻辑本来是挂载在
filter方法的流程下的,但表单提交直接跳转到只返回JSON的search_city接口,既没有对应的视图渲染逻辑,也没有查询关联街道的代码,自然拿不到需要的街道数据。
落地调整方案
- 修正表单提交路由:把搜索表单的提交目标从
search_city_path调整为filter_path,让表单提交后走原本设计好的街道搜索处理流程。 - 补全
filter方法的兜底逻辑:- 优先读取用户选中的geo_code参数,参数缺失时自动取城市列表的第一个城市作为默认选中项,避免空对象报错
- 不管参数是否存在,都先查到有效的City实例,再基于该实例加载关联的街道数据
- 把选中的城市作为下拉选项源注入视图,解决Select2选中值不回填的问题
- 修正Haml视图的表单参数:把
options_for_select的入参直接替换为选项数组,移除无效的collection键嵌套,把输入框的样式类配置从选项参数中移出,作为select标签的独立属性传入。 - 保持
search_city方法的原有功能不变:它只负责响应Select2的输入联想请求,不需要承担表单提交后的街道搜索职责,和原设计的功能边界保持一致。
调整后的核心参考代码
修正后的filter方法:
def filter @city_list = city_list params[:q] ||= {} # 优先取选中的geo_code,无参数时默认取列表第一个城市 selected_geo_code = params.dig(:q, :geo_code_eq) || @city_list&.first&.second # 兜底查有效城市,避免空值报错 @city = Geo::City.find_by(geo_code: selected_geo_code) || Geo::City.find_by(geo_code: @city_list.first.second) # 构建下拉选中项 @collection = [[@city.name, @city.geo_code]] # 基于选中城市加载关联街道并初始化Ransack搜索 base_streets = @city.streets @q = base_streets.ransack(params[:q]) @streets = @q.result.limit(15) end
修正后的Haml表单代码:
= search_form_for @q, url: filter_path do |f| .columns.is-centered{style: 'padding-top: 100px;'} .column.is-half = f.select :geo_code_eq, options_for_select(@collection), { prompt: "选择城市" }, { class: "city-select2 select-input" } = f.submit "Search"
调整完成后整个流程会恢复正常:Select2输入时的联想请求走原有的search_city接口返回匹配的城市候选;用户选中具体城市提交表单时,会携带对应的geo_code参数走filter方法的处理逻辑,查询到关联街道后通过Ransack完成搜索,最终在对应视图中渲染街道搜索结果即可。
内容的提问来源于stack exchange,提问作者Katharina Schreiber
相关产品推荐
相关产品推荐

