Laravel7安装spatie/laravel-multitenancy^1.0时QueueManager报空数组偏移错误

错误原因 #

从错误堆栈可以定位到问题根因：spatie/laravel-multitenancy ^1.0版本在服务提供者启动阶段，会自动初始化租户感知队列逻辑，调用队列管理器的方法时触发了队列连接初始化，但此时读取config/queue.php的对应连接配置返回了null，访问数组下标就抛出了错误。
常见触发场景有两个：

• 你的config/queue.php中default参数指定的队列驱动，在下方connections数组里没有对应的配置项，比如你把QUEUE_CONNECTION环境变量设为了不存在的驱动值
• Laravel 7本身的队列服务提供者启动顺序晚于多租户包的服务提供者，队列配置还未完全加载就被多租户包调用，导致读取配置为空

解决方案 #

步骤1：修复队列配置 #

检查config/queue.php和项目环境变量文件，确保队列配置正确，示例合法配置片段如下：

// config/queue.php
return [
    // 默认驱动对应的配置必须存在于下方connections数组中
    'default' => env('QUEUE_CONNECTION', 'sync'),

    'connections' => [
        'sync' => [
            'driver' => 'sync',
        ],
        // 保留你实际用到的其他驱动配置，比如database、redis等
    ],
];

如果.env文件里的QUEUE_CONNECTION参数设为了不存在的驱动，修改为sync或者你实际在用的合法驱动即可。

步骤2：调整服务提供者注册顺序 #

如果配置无误仍报错，说明是服务启动顺序问题，按以下操作调整：

1. 在composer.json中添加配置，跳过多租户包的自动发现：

"extra": {
    "laravel": {
        "dont-discover": [
            "spatie/laravel-multitenancy"
        ]
    }
}

2. 执行命令重载自动加载：
   composer dump-autoload
3. 打开config/app.php，在providers数组中手动注册多租户服务提供者，放在队列服务提供者之后：

'providers' => [
    // 其他系统服务提供者...
    Illuminate\Queue\QueueServiceProvider::class,
    // 放在队列服务提供者之后
    Spatie\Multitenancy\MultitenancyServiceProvider::class,
],

步骤3：锁定兼容版本 #

如果上述操作仍未解决，直接安装Laravel 7兼容的稳定版本即可：
composer require "spatie/laravel-multitenancy:1.6.4"
该版本是官方确认适配Laravel 7的最后稳定版本，不存在上述队列启动兼容问题。

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