如何修复Laravel队列报错：Instances of Aws\Sqs\SqsClient cannot be serialized

• 核心触发逻辑：Laravel 队列（含批量任务）在执行dispatch分发操作时，会对任务实例、批量任务绑定的then/catch闭包执行序列化，再存储到SQS队列中。而Aws\Sqs\SqsClient实例包含套接字、连接句柄等不可序列化的资源类型，AWS SDK在某次小版本更新中新增了序列化拦截逻辑，直接抛出该错误。
• 无代码变更却突然报错的原因：若你的composer.json中对aws/aws-sdk-php的版本约束允许小版本升级（例如^3.200这类写法），在部署、定时依赖更新时拉取到新增拦截逻辑的版本，就会在无业务代码改动的情况下触发问题。
• 先随机报错后全量失败的原因：只有当闭包的作用域内隐式/显式引用了SqsClient实例时才会触发错误，初期仅部分任务的闭包携带了该实例引用，后续随着依赖更新全量生效、或者所有任务的触发路径都会引入SqsClient引用，最终所有任务都会触发报错。
• 错误栈指向dispatch行的原因：序列化动作在调用dispatch方法时就会执行，而非任务实际消费阶段，因此错误直接在分发步骤抛出。

• 优先方案：调整批量任务闭包的变量引用逻辑，不要在闭包外部引入SqsClient实例或包含该实例的对象，改为在闭包内部通过服务容器动态解析实例，避免序列化阶段携带不可序列化资源。
  错误写法示例：

  // 提前解析SqsClient，通过use传入闭包会触发序列化
  $sqsClient = app(\Aws\Sqs\SqsClient::class);
  Bus::batch($taskList)
    ->then(function () use ($sqsClient) {
        $sqsClient->sendMessage([/* 业务逻辑 */]);
    })
    ->catch(function () use ($sqsClient) {
        // 异常处理逻辑
    })
    ->onConnection($queue_conn)
    ->dispatch();
  

  修复后写法示例：

  Bus::batch($taskList)
    ->then(function () {
        // 闭包内部动态解析，不会被序列化
        $sqsClient = app(\Aws\Sqs\SqsClient::class);
        $sqsClient->sendMessage([/* 业务逻辑 */]);
    })
    ->catch(function () {
        $sqsClient = app(\Aws\Sqs\SqsClient::class);
        // 异常处理逻辑
    })
    ->onConnection($queue_conn)
    ->dispatch();
  

• 临时应急方案：若需要快速恢复业务，可以在composer.json中将aws/aws-sdk-php的版本锁定到未新增序列化拦截的旧版本，执行composer update aws/aws-sdk-php重新安装依赖即可。该方案仅适合临时止损，长期使用可能存在未修复的安全隐患。
• 额外优化：如果是自定义任务类，不要在构造函数中注入SqsClient实例，统一改为在handle方法中动态解析，避免任务类序列化时携带不可序列化资源。

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