Ruby 3.1.1升级后Rails+Google Cloud Task出现ArgumentError求助

算力阿峰

2026-7-20

解决Ruby 3.1.1下Cloudtasker部署GCP任务报错的问题

问题根源

Ruby 3.1对类型处理做了更严格的校验，而cloudtasker 0.13.0版本未适配这种变化——它默认传递的整数超时时间（600秒）无法被GCP Tasks API识别，API要求参数必须是Hash或Google::Protobuf::Duration类型，因此触发ArgumentError。

解决方案

1. 优先升级Cloudtasker到兼容版本

cloudtasker 0.14.0及以上版本已经修复了Ruby 3.1的兼容性问题，直接升级即可解决：

bundle update cloudtasker

升级后重新部署服务，验证任务执行情况。

2. 手动修改超时参数格式（无法升级时）

如果暂时不能升级cloudtasker，把默认的整数超时改成Hash格式，让GCP API能正确解析：

全局配置修改

在config/initializers/cloudtasker.rb中调整超时配置：

Cloudtasker.configure do |config|
  # 替换原来的 config.timeout = 600
  config.timeout = { seconds: 600 }
end

单个Worker配置修改

也可以在你的EnrollmentsValidatorWorker中单独指定：

class EnrollmentsValidatorWorker
  include Cloudtasker::Worker
  cloudtasker_options queue: :enrollments, lock: :while_executing, on_conflict: :reject, timeout: { seconds: 600 }

  def perform
    EnrollmentsValidationByItDataset.call
  rescue StandardError => e
    send_message "Error: #{e.message}. #{e.backtrace.join("\n")}"
  end
end