Laravel 8用TenancyForLaravel 3执行租户代码报错：未配置[tenant]连接

出现"Database connection [tenant] not configured."错误，核心原因是租户的数据库连接未被正确初始化，或是Tenant模型缺少管理租户数据库的必要特性。以下是针对性的解决步骤：

1. 为Tenant模型添加HasDatabase trait #

TenancyForLaravel 3依赖HasDatabase trait来处理租户数据库的连接创建与切换。打开App\Models\Tenant.php，补充该trait：

<?php

namespace App\Models;

use Stancl\Tenancy\Database\Models\Tenant as BaseTenant;
use Stancl\Tenancy\Database\Concerns\HasDatabase;

class Tenant extends BaseTenant
{
    use HasDatabase; // 必须添加这个trait

    // 你的其他模型代码...
}

2. 确保租户数据库已初始化 #

如果租户对应的数据库尚未创建，执行命令生成数据库（替换tenant1为你的租户ID）：

php artisan tenancy:create-database tenant1

同时确保已运行Tenancy相关迁移：

php artisan tenancy:migrate

3. 配置User模型的动态连接（可选） #

如果你的User模型需要在中央和租户上下文间切换数据库连接，在App\Models\User.php中添加动态连接逻辑：

public function getConnectionName()
{
    // 租户上下文初始化时用租户连接，否则用中央默认连接
    return tenancy()->initialized() ? 'tenant' : config('database.default');
}

4. 检查Tenancy配置 #

确认config/tenancy.php中的数据库配置正确，确保tenant_connection设置为tenant（与动态生成的租户连接名称一致）：

'database' => [
    'connection' => 'mysql', // 中央数据库连接
    'tenant_connection' => 'tenant', // 租户连接名称
    // 其他配置...
],

修改后重启应用，再次调用接口即可正常从租户数据库查询用户。

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