Ruby on Rails中Delayed::Job时区异常：任务未按指定时间执行

我之前也碰到过Delayed::Job时区不匹配的棘手问题，结合你描述的情况——数据库里的updated_at、created_at和run_at都是UTC时间，和CST差6小时，任务没按预期时间跑，咱们一步步来解决：

1. 先确认Rails应用的时区配置是否到位 #

首先检查config/application.rb里的时区设置，确保同时配置了应用层和ActiveRecord的时区：

# config/application.rb
config.time_zone = 'Asia/Shanghai' # 对应CST时区，若为美国中部时区可设为'Central Time (US & Canada)'
config.active_record.default_timezone = :local

这里要注意：

• config.time_zone是整个Rails应用使用的时区，视图、控制器里的时间都会遵循这个设置
• config.active_record.default_timezone = :local会让ActiveRecord把应用时区的时间转换为UTC存储到数据库，读取时再自动转回应用时区，这是关键配置

2. 调度任务时用应用时区的时间，别用系统时区 #

很多时候问题出在创建任务时用了Time.now（系统时区），而不是Time.zone.now（应用配置的时区）。比如：

# ✅ 正确：用应用时区的时间来设置run_at
Delayed::Job.enqueue(MyJob.new, run_at: Time.zone.now + 2.hours)

# ❌ 错误：用了系统时区的时间，可能和CST不匹配
Delayed::Job.enqueue(MyJob.new, run_at: Time.now + 2.hours)

Time.zone.now会严格遵循你在config.time_zone里设置的CST，Rails会自动把它转成UTC存储到数据库的run_at字段里。

3. 给Delayed::Job加一层时区转换的补丁 #

如果上面两步做完还是有问题，那可能是Delayed::Job本身没有正确处理时区。可以在config/initializers/delayed_job.rb里加个补丁，强制它使用应用时区处理run_at：

# config/initializers/delayed_job.rb
Delayed::Job.class_eval do
  def run_at=(time)
    if time.present?
      # 把传入的时间转换为应用时区，再转成UTC存储
      super(Time.zone.parse(time.to_s)&.utc || time.utc)
    else
      super
    end
  end
end

这个补丁会确保不管传入的是什么格式的时间，都会先转换为你配置的CST时区，再转成UTC存到数据库，避免时区混乱。

4. 确保Worker进程的时区和应用一致 #

有时候应用配置对了，但Worker进程的系统时区是UTC，导致它读取run_at时按UTC判断执行时间。启动Worker时可以显式指定时区：

# 用rake启动的情况
TZ='Asia/Shanghai' bundle exec rake jobs:work

# 用delayed_job gem启动的情况
TZ='Asia/Shanghai' bundle exec delayed_job start

验证方法 #

最后可以做个小测试：

1. 在Rails控制台创建一个任务，设置run_at为1分钟后的CST时间：

Delayed::Job.enqueue(MyTestJob.new, run_at: Time.zone.now + 1.minute)

2. 查看数据库里的run_at字段，应该是对应CST时间的UTC转换值
3. 等待1分钟，看任务是否准时执行。

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