Hyperf异步队列任务提交失败因Job类混入不可序列化对象，须确保构造函数仅接收基础类型或可序列化数据，依赖在handle()中通过ApplicationContext或@Inject获取，禁止在属性中保存PDO、闭包、模型实例等。
Hyperf异步队列任务提交时抛出“Serialization of closure is not allowed”或“Class xxx is not allowed to unserialize”错误，说明Job类中混入了不可序列化的对象（如PDO实例、闭包、Resource资源），导致Redis序列化失败，任务根本无法入队。
检查Job构造函数是否携带不可序列化对象
第一步：打开你的Job类，定位__construct()方法。
第二步：逐行检查传入参数——禁止将容器对象、数据库连接实例、闭包、文件句柄、Swoole协程上下文等任何非标量或非可序列化对象传入构造函数。
第三步：只保留数组、字符串、整型、布尔值、DateTime、以及你自定义的且实现了Serializable接口（或含__serialize/__unserialize）的轻量模型。例如：$this->orderId = (int)$params['order_id']; 安全；$this->db = $container->get(PDO::class); 会直接报错。
这一步必须做，否则任务连Redis队列都进不去，后续所有配置和重试都无效。
使用ApplicationContext在handle()中获取依赖
方法一：在handle()方法内按需获取服务实例。
use Hyperf\Context\ApplicationContext;
$mailService = ApplicationContext::getContainer()->get(MailService::class);
方法二：用@Inject注解注入（仅限handle()内生效，构造函数中无效）。
#[Inject]protected MailService $mailService;
public function handle(): void { $this->mailService->send(...);}
⚠️注意：@Inject不能放在构造函数里，否则容器实例会被序列化进Redis——这是高频踩坑点。
避免在Job属性中保存对象引用
① 错误写法：public $userModel; → 构造时赋值$this->userModel = User::find(123); → 序列化失败。
② 正确写法：public int $userId; → 构造时只存ID：$this->userId = 123; → handle()中再查：$user = User::find($this->userId);
③ 若必须传递结构化数据，用json_encode转为字符串存储，handle()中json_decode还原。不要直接存Eloquent模型、Collection或Request对象。
Hyperf异步队列只负责把“数据”送进去、“数据”取出来，不是用来搬运运行时对象的搬运工。
启用序列化白名单（PHP 8.4+ 或自定义反序列化逻辑）
如果你确实需要传递自定义类实例，且该类无法改造成纯数据载体，请在类中显式声明可反序列化字段：
class OrderData implements \Serializable { public function __serialize(): array { return ['id' => $this->id, 'amount' => $this->amount]; // 只返回基础类型 } public function __unserialize(array $data): void { $this->id = $data['id'] ?? 0; $this->amount = $data['amount'] ?? 0.0; }}
然后在Job中使用：$this->orderData = new OrderData(...); —— 这样才能安全进入Redis队列。
【关键前提】：确保该类不持有任何闭包、资源句柄或容器引用，否则__serialize仍会触发致命错误。
