RSpec存根期望失败：Rails 5 ActionMailer测试模式存根异常

嘿，我来帮你捋捋这个问题——我之前在Rails 5里测试ActionMailer的时候也踩过类似的坑！咱们一步步拆解可能的原因和解决办法：

首先，先搞清楚：为什么ApplicationMailer的方法会返回nil？ #

在Rails的:test模式下，ActionMailer默认不会真的发送邮件，但正常情况下，调用邮件类的方法（比如ApplicationMailer.your_method(params)）应该返回一个Mail::Message对象，而不是nil。如果返回nil，大概率是你的邮件方法本身有问题：

• 检查邮件方法的最后一行是不是mail(...)块：Ruby方法会返回最后一行代码的结果，如果mail块前面的代码返回了nil（比如找不到记录、条件判断不通过），那整个方法就会返回nil。举个例子：

  def alert_admin(alert)
    # 如果alert不存在，这行返回nil，方法就直接返回nil了
    alert = Alert.find_by(id: alert_id)
    mail(to: 'admin@example.com', subject: 'Alert Triggered')
  end
  

• 确认你的ApplicationMailer没有被错误地重载了核心方法，比如initialize或者method_missing，导致动态生成的邮件方法失效。

然后，为什么RSpec的期望有的过有的不过？ #

这个情况最常见的几个原因：

1. 存根错了对象
   ActionMailer的子类（比如UserMailer < ApplicationMailer）的邮件类方法是动态生成的，不会继承父类的存根。如果你实际代码里调用的是子类的方法（比如UserMailer.welcome(user)），但你存根的是ApplicationMailer，那这个存根完全不会生效，期望自然会失败；但如果某个测试真的调用了ApplicationMailer本身的方法，期望就会通过——这就会出现“有的过有的不过”的诡异情况。

   解决办法：存根你实际调用的那个邮件类，比如如果用的是UserMailer，就存根UserMailer，而不是它的父类。

2. RSpec期望的类型搞混了
   RSpec有两种验证方法调用的方式，用错了就会失败：

   • 前置期望：expect(ApplicationMailer).to receive(:your_method) —— 这种方式不需要提前存根，它会自动存根并验证调用，但必须写在方法调用之前。
   • 后置期望：expect(ApplicationMailer).to have_received(:your_method) —— 这种方式必须先提前用allow(ApplicationMailer).to receive(:your_method)存根，否则RSpec不会记录方法调用，自然验证失败。

   如果你有的测试用了正确的顺序/类型，有的没，就会出现部分通过的情况。

3. deliver_later的异步坑
   如果你的代码用了deliver_later而不是deliver_now，那在Rails 5里默认会用Active Job异步执行。这时候直接存根邮件方法可能抓不到调用，因为实际是Active Job去调用的。

   解决办法：

   • 测试环境里确保config.active_job.queue_adapter = :test（默认应该是这个，但可以检查config/environments/test.rb）。
   • 用RSpec的Active Job匹配器来验证，比如：

     expect { ApplicationMailer.alert_admin(alert).deliver_later }.to have_enqueued_job(ActionMailer::DeliveryJob)
     

4. 存根的作用域问题
   如果你在before(:each)里存根，但某个测试用例里又重新存根了同一个方法，就会覆盖之前的存根，导致期望验证失败。比如某个测试里写了allow(ApplicationMailer).to receive(:your_method).and_return(nil)，那就会覆盖全局的存根逻辑。

最后，给你几个快速排查的小技巧 #

• 在测试里加一行puts ApplicationMailer.your_method(params).inspect，看看实际返回值到底是什么，确认是不是方法本身返回nil。
• 用rspec --debug运行单个测试，看看方法调用的栈追踪，确认到底是哪个类的哪个方法被调用了。
• 暂时去掉所有存根，用ActionMailer的测试默认行为：检查ActionMailer::Base.deliveries数组，看看邮件是不是被正确生成了，比如：

  ApplicationMailer.alert_admin(alert).deliver_now
  expect(ActionMailer::Base.deliveries.last.subject).to eq('Alert Triggered')
  

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