Sidekiq异常问题：has_one_attached之后的模型方法无法加载

针对你遇到的Rails 6.1.7.8 + Sidekiq 7.3.1生产环境的异常，给你几个排查方向：

• 强制预加载模型类
  Rails生产环境默认关闭自动加载，Sidekiq进程启动时可能没完整加载模型的全部定义。在config/initializers/sidekiq.rb里添加：

  Rails.application.eager_load!
  # 或者针对特定模型预加载，避免全量预加载影响性能
  # require_dependency 'your_model_name'
  

  之后重启Sidekiq进程，确保模型的所有方法都被加载。

• 检查Active Storage加载时机
  has_one_attached属于Active Storage模块，若Sidekiq进程中Active Storage初始化晚于模型加载，可能导致模型后续方法未被正确解析。在Sidekiq初始化文件里提前加载Active Storage：

  require "active_storage/engine"
  Rails.application.config.active_storage.service = :your_service_name
  

• 避免直接传递ActiveRecord对象到任务
  Sidekiq传递对象时实际序列化的是ID，但重新加载实例时若模型类未完整加载，就会出现方法缺失。修改任务代码，改为传递ID后手动加载：

  class MyJob
    include Sidekiq::Job
  
    def perform(model_id)
      model = YourModel.find(model_id)
      # 后续调用模型方法
    end
  end
  

• 重启Sidekiq进程
  代码部署后如果没重启Sidekiq，进程会保留旧的模型定义，导致新添加的方法无法被识别。直接重启生产环境的Sidekiq服务即可。

• 检查模型文件的条件加载逻辑
  确认模型中has_one_attached :pdf之后的方法没有被环境判断（比如if Rails.env.development?）包裹，导致生产环境下这些方法未被定义。

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