ActiveMailer无法从Rake任务发送邮件问题排查

问题场景 #

有一批需要通过Rake任务发送的邮件，send_notifications.rake文件内容如下：

desc "Send today's notifications."
task send_notifications: :environment do
  require 'time'
  puts 7.days.from_now
  
  phases = TeamProjectPhase.all
  phases.each do |phase|
    if phase.ends == 7.days.from_now && !phase.admin_confirmed
      TeamMailer.due_date_approaching(phase).deliver
    end
  end

  phases = TeamProjectPhase.all
  phases.each do |phase|
    if phase.ends.today? && !phase.admin_confirmed
      TeamMailer.due_date_here(phase).deliver
    end
  end

  phases = TeamProjectPhase.all
  phases.each do |phase|
    if phase.ends.today? && !phase.admin_confirmed
      TeamMailer.due_date_missed_admin(phase).deliver
    end
  end

  tasks = TeamTask.all
  tasks.each do |task|
    if task.due == 7.days.from_now && !task.admin_confirmed
      TeamMailer.task_due_date_approaching(task).deliver
    end
  end

  tasks = TeamTask.all
  tasks.each do |task|
    if task.due.today? && !task.admin_confirmed
      TeamMailer.task_due_date_here(task).deliver
    end
  end

  tasks = TeamTask.all
  tasks.each do |task|
    if task.due.today? && !task.admin_confirmed
      TeamMailer.task_due_date_missed_admin(task).deliver
    end
  end

end

已确认执行rake send_notifications时代码能进入对应任务或阶段的正确if分支，但所有邮件都无法发送，尝试过deliver和deliver_now两种方式均无效。

排查方向及解决办法 #

1. 时间匹配精度问题 #

你用phase.ends == 7.days.from_now做判断时，7.days.from_now会返回带时分秒的精确时间，但数据库中ends字段可能仅存储日期（时分秒默认00:00:00），二者很难完全匹配。哪怕测试时看到进入分支，也可能是巧合的时间对齐，实际运行时大概率触发失败。

• 修正方案：改用日期维度匹配，忽略时分秒差异：

  # 匹配7天后当天的所有记录
  if phase.ends.to_date == 7.days.from_now.to_date && !phase.admin_confirmed
  

  同理，phase.ends.today?建议替换为phase.ends.to_date == Date.today，逻辑更明确，避免因时间字段的存储格式导致判断异常。

2. 邮件发送环境配置问题 #

Rake任务会默认使用当前Rails环境的邮件配置，不同环境的发送规则不同：

• 开发环境：默认不会实际发送邮件，仅会在日志或预览中记录。需修改config/environments/development.rb开启发送：

  config.action_mailer.perform_deliveries = true
  config.action_mailer.raise_delivery_errors = true
  

  开启raise_delivery_errors后，发送失败时会抛出具体错误，方便定位问题（比如SMTP地址错误、认证失败）。
• 生产环境：检查config/environments/production.rb中的SMTP配置，确认服务器地址、端口、用户名密码、SSL设置等是否正确，这些配置错误是生产环境邮件发送失败的常见原因。

3. 邮件发送方法调用规范 #

Rails 5+版本中deliver已被弃用，推荐使用deliver_now或deliver_later：

• deliver_now：同步发送邮件，适合Rake任务这种一次性执行的场景，无需依赖队列服务。
• deliver_later：异步发送，需要Sidekiq、Resque等队列服务运行，否则邮件会积压在队列中无法发送。如果你之前用了deliver_later但没启动队列，就会出现代码执行但邮件不发的情况。

4. 日志排查 #

查看Rails对应环境的日志文件（如log/development.log或log/production.log），搜索Sent mail、Delivery failed等关键词，日志中会包含邮件发送的详细信息，比如收件人格式错误、SMTP连接超时、认证失败等具体问题。

• 也可以在Rake任务中添加临时日志，确认邮件对象是否正确生成：

  mail = TeamMailer.due_date_approaching(phase)
  puts "准备发送邮件至：#{mail.to}"
  mail.deliver_now
  

5. 代码冗余优化（附带潜在问题规避） #

你多次重复查询TeamProjectPhase.all和TeamTask.all，不仅浪费数据库资源，还可能因查询间隔中数据变化导致逻辑不一致。可以优化为单次查询+多条件判断：

desc "Send today's notifications."
task send_notifications: :environment do
  require 'time'
  seven_days_later = 7.days.from_now.to_date
  today = Date.today
  
  # 处理阶段通知
  TeamProjectPhase.where(admin_confirmed: false).each do |phase|
    phase_end_date = phase.ends.to_date
    if phase_end_date == seven_days_later
      TeamMailer.due_date_approaching(phase).deliver_now
    elsif phase_end_date == today
      TeamMailer.due_date_here(phase).deliver_now
      TeamMailer.due_date_missed_admin(phase).deliver_now
    end
  end

  # 处理任务通知
  TeamTask.where(admin_confirmed: false).each do |task|
    task_due_date = task.due.to_date
    if task_due_date == seven_days_later
      TeamMailer.task_due_date_approaching(task).deliver_now
    elsif task_due_date == today
      TeamMailer.task_due_date_here(task).deliver_now
      TeamMailer.task_due_date_missed_admin(task).deliver_now
    end
  end
end

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