Laravel多租户数据库队列任务配置及1046无数据库报错解决

问题根源 #

Laravel队列worker启动时会立即尝试连接数据库拉取待处理任务，而你的多租户场景下，worker启动阶段还未执行任务内的动态数据库配置，同时jobs/failed_jobs表存于独立库，导致worker启动时找不到指定数据库，抛出1046错误。

分步解决 #

1. 新增队列专用数据库连接

在config/database.php中添加一个独立连接，指向存储jobs和failed_jobs的数据库：

'queue' => [
    'driver' => 'mysql',
    'host' => env('DB_QUEUE_HOST', '127.0.0.1'),
    'port' => env('DB_QUEUE_PORT', '3306'),
    'database' => env('DB_QUEUE_DATABASE', 'queue_database'),
    'username' => env('DB_QUEUE_USERNAME', 'root'),
    'password' => env('DB_QUEUE_PASSWORD', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
],

在.env文件中补充对应环境变量：

DB_QUEUE_DATABASE=你的队列数据库名
DB_QUEUE_HOST=数据库地址
DB_QUEUE_USERNAME=数据库用户名
DB_QUEUE_PASSWORD=数据库密码

2. 配置队列使用专用连接

修改config/queue.php，让database驱动的队列使用刚才新增的queue连接：

'connections' => [
    // 其他队列驱动保持不变
    'database' => [
        'driver' => 'database',
        'table' => 'jobs',
        'queue' => 'default',
        'retry_after' => 90,
        'connection' => 'queue', // 指定队列专用连接
    ],
],

同时配置失败任务存储也使用该连接：

'failed' => [
    'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
    'database' => 'queue', // 指向队列专用连接
    'table' => 'failed_jobs',
],

3. 任务内动态切换租户数据库（确保生效）

在任务的handle方法中，修改数据库配置后必须清除连接缓存并重新连接，否则Laravel会沿用启动时的旧连接：

public function handle()
{
    // 从任务参数中获取租户数据库名称（根据你的业务调整）
    $tenantDbName = $this->tenant->database_name;

    // 动态设置租户数据库
    Config::set('database.connections.mysql.database', $tenantDbName);
    // 清除旧连接缓存并重新连接
    DB::purge('mysql');
    DB::reconnect('mysql');

    // 后续业务逻辑将自动使用租户数据库
    // ...你的业务代码
}

4. 启动worker

直接启动worker即可，无需额外参数（因为已经在配置中指定了队列连接）：

php artisan queue:work

关键说明 #

• worker启动时优先读取队列配置中的数据库连接，确保拉取任务时能访问到jobs表
• 任务内的purge和reconnect是核心，必须执行才能让动态配置的租户数据库生效

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