RSpec测试Rails自定义Mailer发送邮件时Stub未拦截到调用的问题

核心报错根因 #

• 自定义的类双未实际生效：你定义的user_mailer_double是独立的测试替身，没有通过RSpec的常量替换机制绑定替换真实的UserMailer类常量，被测代码执行时调用的始终是原生的UserMailer类，完全不会触发替身的接收预期，因此测试结果显示接收0次调用。
• 调用链路的匹配逻辑完全错位：Rails内置的ActionMailer调用结构是分层的：
  1. 先在Mailer类上调用.with(参数)方法，返回携带参数的Mailer实例
  2. 再在返回的实例上调用对应的邮件方法（如welcome_email）
     你写的期望是直接在UserMailer类上调用携带user参数的welcome_email方法，和真实的调用结构从根本上不匹配，就算替换了类常量也无法命中。

正确的测试实现 #

方案1：按调用链路匹配替身调用 #

这种写法可以完整校验邮件触发的全链路逻辑：

let(:user) { create(:user) }
it 'triggers welcome email delivery' do
  # 构造实例替身，模拟with方法的返回值
  mailer_instance = instance_double(UserMailer)
  # 替换真实的UserMailer类的with方法，返回构造好的实例替身
  allow(UserMailer).to receive(:with).with(user: user).and_return(mailer_instance)
  # 模拟实例上的方法链式调用
  allow(mailer_instance).to receive(:welcome_email).and_return(mailer_instance)
  allow(mailer_instance).to receive(:deliver_later)

  # 执行被测逻辑（subject为触发邮件的业务动作，如用户创建回调）
  subject

  # 逐段校验调用逻辑是否符合预期
  expect(UserMailer).to have_received(:with).with(user: user)
  expect(mailer_instance).to have_received(:welcome_email)
  expect(mailer_instance).to have_received(:deliver_later)
end

方案2：直接校验邮件入队状态（更贴近真实运行逻辑） #

不需要手动构造替身，直接借助ActionMailer内置的测试能力验证邮件是否被正确加入发送队列：

it 'enqueues welcome email for new user' do
  expect {
    subject
  }.to have_enqueued_mail(UserMailer, :welcome_email).with(user)
end

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