Ruby升级至3.2.2时RSpec中args/kwargs处理问题求助

为什么之前能正常运行？ #

1. ActionMailer的自动转发机制：CustomMailer继承自ActionMailer::Base，Rails框架为ActionMailer类实现了method_missing方法。当调用CustomMailer.request_email(...)类方法时，框架会自动创建CustomMailer实例，再在实例上调用对应的request_email实例方法——这是Rails为简化邮件调用设计的机制，所以实例方法能被当作类方法调用。
2. Ruby关键字参数兼容性：Ruby 2.7到3.0处于关键字参数过渡阶段，允许将哈希隐式转换为关键字参数。即便Rails转发时参数处理存在小问题，Ruby也能兼容把{request: request}哈希解析为关键字参数，因此在Ruby 2.7.8和3.0.6中可正常运行。

为什么Ruby 3.1+会报错？ #

Ruby 3.1彻底移除了“哈希隐式转为关键字参数”的兼容逻辑，严格区分位置参数与关键字参数。此时旧版本Rails的method_missing转发逻辑，会把传入的request: request关键字参数打包成单个哈希作为位置参数传递给实例方法，但request_email(request:, csv: nil)期望的是关键字参数，因此触发ArgumentError——收到1个位置参数，方法却期望0个位置参数且必须传入关键字参数request:。

修复方案 #

方案1：升级Rails到兼容Ruby 3.1+的版本 #

Rails 6.1.5+、7.x版本已修复Ruby 3.1+下ActionMailer的参数转发问题，确保关键字参数能被正确传递。若项目允许升级Rails，这是最彻底的解决方案，原有调用代码和实例方法无需修改。

方案2：修改实例方法，兼容位置参数与关键字参数 #

若暂时无法升级Rails，可修改request_email的参数定义，让它同时支持两种参数传递方式：

def request_email(request = nil, csv: nil)
  # 兼容Rails转发时传递的哈希位置参数
  if request.is_a?(Hash)
    csv = request[:csv]
    request = request[:request]
  end

  # 原有数据处理逻辑
  recipients = request.email
  sender = request.sender
  subject = "Some subject"

  mail(to: recipients, subject: subject, from: sender)
end

方案3：使用ActionMailer的with方法显式传递参数 #

这是ActionMailer的最佳实践，能完美兼容Ruby 3.1+的参数规则：

• 调用代码修改：

  let(:mail) { CustomMailer.with(request: request).request_email }
  

• 方法实现修改：

  def request_email(csv: nil)
    request = params[:request]
    # 原有数据处理逻辑
    recipients = request.email
    sender = request.sender
    subject = "Some subject"
  
    mail(to: recipients, subject: subject, from: sender)
  end
  

为什么改成类方法会报错？ #

mail是ActionMailer::Base提供的实例方法，它依赖实例内部的邮件配置、视图渲染上下文等，仅能在ActionMailer实例上下文中调用。直接将request_email改为类方法后，调用mail时处于类上下文，自然触发NoMethodError——因此ActionMailer的邮件方法必须定义为实例方法。

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