Rails 6 中Active Job无法执行异步邮件任务，报不支持User参数类型错误

deliver_later的本质是将邮件发送任务封装为Active Job对象，将参数序列化后入队，等待后续异步执行。Active Job对入队参数有严格的类型限制：仅支持基础数据类型（字符串、数值、布尔值、nil、数组、哈希），以及可通过GlobalID反序列化的轻量模型引用，不支持直接将完整的ActiveRecord模型实例作为入队参数。
你遇到的这个报错，就是因为调用UserMailer.with(user: @user)时，把完整的User模型实例塞进了待入队的参数集合，序列化器识别到非支持的对象类型后直接抛出Unsupported argument type: User异常。

为什么换成deliver_now就能正常运行？
因为deliver_now是同步在当前请求进程内完成邮件渲染、发送的全流程，全程不需要将任务参数序列化入队，自然不会触发类型检查逻辑。这个表现也能证明：问题和Active Job的:async适配器完全无关，不管你更换哪种队列后端（Sidekiq、Resque等），只要参数不符合序列化规则，都会抛出完全相同的错误。

你觉得实现逻辑和官方指南一致却触发报错，通常是以下几个原因导致框架的自动序列化逻辑没有生效：

• 使用的Rails版本低于5.2：这个版本之前的Action Mailer在调用deliver_later时，不会自动对传入的ActiveRecord参数做GlobalID序列化转换，必须手动传递可序列化的基础类型参数
• User模型未正确继承自ApplicationRecord/ActiveRecord::Base，导致框架的GlobalID识别逻辑失效
• 自定义配置了Active Job的参数序列化逻辑，移除了对GlobalID类型的支持

方案一（零依赖、可控性最强，推荐生产环境使用） #

入队时仅传递用户的唯一ID（属于Active Job原生支持的整数类型，无序列化兼容问题），在Mailer方法执行阶段再从数据库加载用户数据：

1. 调整控制器中的调用逻辑，仅传递user_id参数：

   def create
     @user = User.create(user_params)
   
     if @user && UserMailer.with(user_id: @user.id).welcome_email.deliver_later
        token = encode_token({ user_id: @user.id })
        render json: { token: token }, status: :created
     else
        render json: @user.errors.messages, status: :bad_request
     end
   end
   

2. 调整Mailer实现，根据传入的id加载用户记录：

   class UserMailer < ApplicationMailer
     default from: 'notifications@example.com'
   
     def welcome_email
       @user = User.find(params[:user_id])
       @url  = 'http://example.com/login'
       mail(to: @user.email, subject: 'Welcome to My Awesome Site')
     end
   end
   

这种写法完全不依赖Rails内置的自动序列化逻辑，不管用哪个版本的Rails、哪种队列适配器都不会出现序列化报错；同时可以在Mailer的方法中自定义用户记录找不到时的兜底逻辑（比如直接终止邮件发送），可控性更强。

方案二（匹配官方指南写法） #

如果你的Rails版本≥5.2，满足GlobalID自动序列化的前提，也可以保持原来的传参方式。框架会自动把传入的User实例转换成可序列化的GlobalID引用串入队，任务执行时再自动反序列化加载对应的记录。不过这种写法存在潜在风险：如果任务入队后、执行前，对应的用户记录被删除，异步任务执行时会直接抛出RecordNotFound错误，没有自定义兜底逻辑的空间。

内容的提问来源于stack exchange，提问作者João Ramires