Rake任务报错：undefined local variable or method `user' 问题排查

我创建了一个用于邮件发送的Rake任务，打算通过Crontab和Whenever gem实现自动化，给用户发送邮件，目前只是测试任务能不能正常运行。以下是我的Rake任务和Mailer代码：

require 'rake'
desc 'send digest email'
task send_warn_course: :environment do
  MailCourseWarnMailer.course_available(user).deliver!
end

# 我的Mailer代码：
class MailCourseWarnMailer < ActionMailer::Base
  def course_available(user)
    @user = user
    mail(to: @user.email, subject: "Curso disponível")
  end
end

运行rake send_warn_course时出现了错误：

rake send_warn_course
rake aborted!
NameError: undefined local variable or method `user' for main:Object

请问出现该问题的原因是什么？我遗漏了哪些内容？

嘿，这个错误的原因其实很直白——你的Rake任务里直接调用了user这个变量，但这个变量根本没在任务里定义过，Ruby不知道它指代的是什么对象，所以就抛出了NameError。

你遗漏的核心内容是：在Rake任务中，需要先获取到要发送邮件的用户实例（或者用户集合），才能传递给Mailer的方法。

根据你的测试需求，这里有两种常见的修改方案：

方案1：测试单个特定用户 #

如果只是想验证邮件发送功能正常，可以手动指定一个测试用户，比如通过ID查找：

require 'rake'
desc 'send digest email'
task send_warn_course: :environment do
  # 替换成你系统中存在的用户ID
  user = User.find(1)
  MailCourseWarnMailer.course_available(user).deliver!
end

方案2：给所有用户发送邮件 #

如果是要实现批量发送的逻辑，就遍历用户集合：

require 'rake'
desc 'send digest email'
task send_warn_course: :environment do
  User.all.each do |user|
    MailCourseWarnMailer.course_available(user).deliver!
    # 可选：添加延迟避免邮件服务器限流
    sleep 1
  end
end

另外还要注意，在生产环境中批量发送邮件时，最好使用异步任务队列（比如Sidekiq）来处理，避免Rake任务长时间占用资源，或者触发邮件服务商的限流机制。

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