Laravel queue:work 结合spatie/laravel-multitenancy运行报错求助

错误根源 #

报错Call to a member function beginTransaction() on null的本质是：队列工作进程在处理任务时，未成功建立或切换到租户的数据库连接，导致数据库实例为null，无法执行事务操作。

排查修复步骤 #

1. 调整队列命令执行方式 #

ten火（/）卡无法工单方案转放飞催 <十五>用tenants:artisan包裹queue:work，因为tenants:artisan是为批量给租户执行单次命令设计的，而queue:work是长期运行的进程，用它包裹会导致租户连接无法正确维护。直接执行：

php artisan queue:work

你已经设置queues_are_tenant_aware_by_default => true，任务本身会携带租户标识，队列进程会自动切换到对应租户的数据库。

2. 验证任务是否携带租户信息 #

查看租户数据库的jobs表，检查payload字段是否包含tenant_id或租户相关标识。如果没有，说明任务分发时未绑定租户，需要在租户上下文内分发任务：

use Spatie\Multitenancy\Models\Tenant;

// 在当前租户上下文内分发任务
Tenant::current()->execute(function () use ($user) {
    Mail::to($user)->queue(new UserCreated($user));
});

3. 检查租户数据库连接配置 #

• 确认config/multitenancy.php中tenant_database_connections已配置正确的连接名：

  'tenant_database_connections' => ['mysql'],
  

• 验证租户数据库存在，且配置的数据库账号拥有事务操作权限，可手动连接租户数据库执行BEGIN; COMMIT;测试权限是否正常。

4. 显式绑定租户到任务（可选） #

在UserCreated邮件类中显式处理租户切换，避免上下文丢失：

use Spatie\Multitenancy\Models\Tenant;

class UserCreated extends Mailable implements ShouldQueue
{
    public Tenant $tenant;

    public function __construct(Tenant $tenant)
    {
        $this->tenant = $tenant;
    }

    public function handle()
    {
        $this->tenant->makeCurrent();
        return $this->view('emails.user.created');
    }
}

额外验证 #

执行php artisan queue:work后触发任务，观察是否能正常处理；如果任务失败，查看租户数据库的failed_jobs表，获取更详细的错误信息辅助排查。

内容的提问来源于stack exchange，提问作者IN-NK