生产环境中Whenever触发uninitialized constant Item错误求助

你遇到的这个问题很典型——明明模型类Item在models目录下，但cron环境运行Rails runner时就是找不到它。这通常和cron的特殊运行环境、Spring预加载的干扰有关，下面给你几个针对性的解决方案：

1. 禁用Spring预加载 #

Spring是Rails的预加载工具，但在cron这种非交互式环境下，它经常会导致类加载异常。你可以直接在cron命令里添加环境变量禁用它：

修改crontab中的任务命令为：

0 2 * * * /bin/bash -l -c 'cd /var/www/rails/myapp && DISABLE_SPRING=1 bundle exec bin/rails runner -e production '\''Item.reload'\'' >> /var/www/rails/myapp/log/cron.log 2>&1'

或者在schedule.rb里统一配置，让Whenever生成的命令自动带上这个设置：

set :default_env, { 'DISABLE_SPRING' => '1' }

2. 强制触发模型加载 #

有时候cron环境下Rails的自动加载机制没完全生效，你可以在runner命令里手动指定加载模型文件：

修改schedule.rb中的任务：

every 1.day, at: '02:00' do
  runner 'require "#{Rails.root}/app/models/item.rb"; Item.reload'
end

另外也可以检查下schedule.rb里的环境设置是否正确，确保set :environment, :production已经生效，避免加载了错误环境的配置。

3. 修正cron的环境变量 #

cron的运行环境和你平时登录shell的环境差异很大，很多关键环境变量（比如PATH、GEM_HOME）可能没正确设置，导致bundle或rails命令调用了错误的版本。

你可以在crontab顶部添加必要的环境变量：

PATH=/usr/local/rbenv/shims:/usr/local/rbenv/bin:/usr/local/bin:/usr/bin:/bin
RAILS_ENV=production

或者在命令中先加载shell的环境配置文件：

0 2 * * * /bin/bash -l -c 'source ~/.bash_profile && cd /var/www/rails/myapp && DISABLE_SPRING=1 bundle exec bin/rails runner -e production '\''Item.reload'\'' >> /var/www/rails/myapp/log/cron.log 2>&1'

4. 先手动验证命令 #

先在服务器的shell里手动执行cron中的命令，看看是否能正常运行：

cd /var/www/rails/myapp && DISABLE_SPRING=1 bundle exec bin/rails runner -e production 'Item.reload'

如果手动执行没问题，那基本可以确定是cron的环境变量问题；如果手动也报错，那就要检查模型代码本身或者Rails环境初始化的问题了。

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