Rails 6通配符搜索表单formula_like scope无过滤效果问题排查

问题根因排查方向 #

1. 首先验证scope本身是否正常工作 #

直接在Rails控制台执行测试代码，排除scope定义问题：

# 替换YourModel为你实际的模型类名
YourModel.formula_like("N*").to_sql

如果输出的SQL语句中包含WHERE formula ILIKE 'N%'的片段，且实际执行返回的结果符合预期，说明scope定义无问题，问题出在参数传递或上层调用环节。

2. 检查强参数配置 #

Rails 6对强参数的校验逻辑比Rails 5更严格，如果你是基于白名单参数来触发搜索逻辑，大概率是formula_like参数没有加入到允许的参数列表中，被默认过滤掉了。
在控制器的搜索动作中添加日志验证：

Rails.logger.debug "原始参数formula_like: #{params[:formula_like]}"
Rails.logger.debug "过滤后的强参数: #{search_params}" # 替换为你实际的强参数方法名

提交搜索后查看日志，如果原始参数有值但强参数中无该字段，在强参数的permit方法中添加:formula_like即可。

3. 检查scope调用逻辑 #

确认你在控制器中已经编写了对应参数的scope调用代码，示例逻辑如下：

def index
  @records = YourModel.all
  # 确保存在这行调用逻辑，且判断条件正确
  @records = @records.formula_like(params[:formula_like]) if params[:formula_like].present?
  # 其他搜索条件的处理
end

如果使用了Ransack之类的搜索gem，需要将自定义scope显式加入到模型的可搜索scope列表中：

class YourModel < ApplicationRecord
  # 如果你用了ransack，需要加这行配置
  self.ransackable_scopes = [:formula_like]
end

4. 验证表单参数传递 #

提交搜索后查看浏览器地址栏（GET提交）或网络请求的表单数据（POST提交），确认formula_like参数已经被正确传递。如果参数不存在，检查外层表单标签是否配置正确，Rails 6默认引入的Turbo/Turbolinks也可能导致表单提交异常，可暂时关闭相关功能验证。

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