使用Solidus+solidus_searchkick集成Elasticsearch时出现deep_symbolize_keys方法未定义错误

这个错误的根源很明确：在较新的Rails版本里，ActionController::Parameters不再继承自普通的Hash，而deep_symbolize_keys是Hash类独有的方法——直接把params对象传给build_searcher，自然会触发这个报错。

修复方案 #

你只需要把params转换成带符号键的普通Hash，再传入build_searcher即可。这里有两种实用的处理方式：

方式1：用to_unsafe_h快速转换（适合首页搜索这类无严格参数限制的场景）

修改控制器里的build_searcher调用，把params.merge(...)替换成params.to_unsafe_h.deep_symbolize_keys.merge(...)：

Spree::HomeController.class_eval do
  def index
    @searcher = build_searcher(params.to_unsafe_h.deep_symbolize_keys.merge(include_images: true))
    @products = @searcher.retrieve_products
    @taxonomies = Spree::Taxonomy.includes(root: :children)
    # 其他原有代码...
  end
end

方式2：强参数+to_h（更安全，推荐用于有明确参数范围的场景）

如果你的搜索有固定的允许参数（比如关键词、分类ID等），先通过强参数过滤再转换，能避免潜在的参数注入风险：

Spree::HomeController.class_eval do
  def index
    permitted_params = params.permit(:keywords, :taxon_id, :price_min, :price_max).to_h
    @searcher = build_searcher(permitted_params.deep_symbolize_keys.merge(include_images: true))
    @products = @searcher.retrieve_products
    @taxonomies = Spree::Taxonomy.includes(root: :children)
    # 其他原有代码...
  end
end

为什么这样有效？ #

• to_unsafe_h会把ActionController::Parameters转换成普通Ruby Hash（注意：该方法会保留所有参数，适合公开搜索这类无需严格校验的场景）
• deep_symbolize_keys会把Hash里的所有字符串键转为符号键，这正是solidus_searchkick的build_searcher方法期望的参数格式
• 强参数的方式先过滤掉非法参数，再转Hash，安全性更高

内容的提问来源于stack exchange，提问作者Fábio Araújo