Rails控制器改名后before_action设置的全局参数不生效如何解决

NoMethodError ... undefined method to_key' for #Author::ActiveRecord_Relation 这个报错的本质是：*视图表单接收的@author变量是ActiveRecord集合对象，而非单个Author模型实例*。to_key`是Rails为单个ActiveRecord实例提供的内置方法，用于生成表单对应的资源路由参数，集合对象没有该方法，所以调用时抛出异常。

修改控制器名称后才出现该问题，通常是以下几类原因导致：

• before_action声明位置错误：before_action这类回调配置必须写在控制器的公共作用域（private关键字上方），如果修改控制器代码时不小心将这行配置挪到了私有作用域下，回调不会触发，set_author方法不会自动执行，@author就不会被赋值为单个实例。
• 路由映射不匹配：控制器重命名后路由配置没有同步修改，你当前访问的请求命中的动作不在only指定的show、edit、update、destroy列表中，回调自然不会运行。
• 其他回调覆盖赋值：控制器或继承的父控制器中存在其他后置回调，在set_author执行完成后重写了@author的值，将其改为了Author.where(xxx)这类返回集合的查询结果。

1. 先检查回调配置位置：确认before_action :set_author,only: %i[ show edit update destroy ]这行代码是写在控制器类中private关键字的上方，不属于私有作用域。
2. 验证set_author是否正常执行：在方法内加入日志确认运行状态：

def set_author
  Rails.logger.info "set_author触发，参数id为#{params[:id]}"
  @author = Author.find(params[:id])
  Rails.logger.info "赋值后@author类型为#{@author.class}"
end

触发请求后查看日志，如果没有对应输出，说明回调确实没有运行。
3. 校验路由配置：执行rails routes命令，确认你访问的路径对应的控制器动作属于only指定的四个动作范围内，路由和控制器名称匹配。
4. 排查重复赋值：搜索控制器和父控制器内所有对@author赋值的代码，确认没有其他语句在set_author执行后将@author修改为集合。
5. 临时修复方案：如果暂时找不到回调失效的根因，可以直接在需要的动作中手动调用set_author方法：

def edit
  set_author
  # 原有逻辑
end

内容的提问来源于stack exchange，提问作者Hưng Tiến Bùi Đỗ