Rails 5中deliver_later浏览器正常但集成测试失败如何解决？

嘿，我之前也碰到过几乎一模一样的问题！把邮件从同步的deliver_now改成异步的deliver_later后，浏览器里跑正常但测试失败，核心差异基本都和异步任务的执行逻辑有关——毕竟浏览器环境下Rails会自动处理后台任务，但测试环境默认是“攒着job不执行”的状态。下面是几个你可以快速排查的方向：

1. 先检查测试环境的Job适配器配置 #

Rails测试环境默认用的是:test适配器，这个适配器只会把job加入队列，但不会实际执行。如果你的集成测试需要邮件真的发送（或者job真的跑完），得改成同步执行的适配器：
打开config/environments/test.rb，把这行：

config.active_job.queue_adapter = :test

改成：

config.active_job.queue_adapter = :inline

这样deliver_later就会和deliver_now一样立刻执行，和浏览器环境的逻辑对齐。如果你不想全局改，也可以在单个测试里临时切换：

setup do
  ActiveJob::Base.queue_adapter = :inline
end

2. 测试里没显式等待Job完成 #

要是不想改全局适配器，也可以在测试代码里用perform_enqueued_jobs包裹触发邮件的操作，强制执行队列里的job：

perform_enqueued_jobs do
  # 这里放触发邮件的代码，比如提交表单、调用邮件器方法
end

或者在测试的after钩子批量执行所有入队的job：

after :each do
  perform_enqueued_jobs
end

3. 警惕测试中对象被提前销毁 #

异步任务执行时，可能测试里的数据库清理工具（比如database_cleaner）已经把邮件依赖的对象删掉了——比如你创建了一个用户，触发邮件后，测试结束前用户被清理，deliver_later的job去读这个用户时就会报错。
解决办法：

• 要么用:inline适配器让job同步执行（对象还在的时候就跑完）；
• 要么把邮件器的参数从对象改成ID，在邮件器里重新查找：

# 原来的写法（直接传对象）
UserMailer.welcome_email(user).deliver_later

# 改成传ID，邮件器内部查对象
UserMailer.welcome_email(user.id).deliver_later

# 邮件器代码
def welcome_email(user_id)
  @user = User.find(user_id)
  # ... 后续逻辑
end

4. 把完整错误日志打出来 #

你提到的ERROR -- : Error per...太模糊了，建议在测试环境开启debug级别的日志，找到具体报错点：
在config/environments/test.rb里加一行：

config.log_level = :debug

同时确保邮件发送的错误会被抛出：

config.action_mailer.raise_delivery_errors = true

这样就能看到是找不到对象、参数错误，还是邮件模板的问题了。

5. 确认测试环境的邮件发送开关 #

最后再检查下测试环境有没有开启邮件发送：

# config/environments/test.rb
config.action_mailer.perform_deliveries = true

虽然浏览器里正常，但测试环境默认可能把这个设为false，导致邮件根本没触发。

最常见的问题其实就是适配器没改，先试试把适配器换成:inline，大概率能解决。如果还是不行，看完整错误日志就能定位到具体原因啦！

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