Tenancy for Laravel v3 租户数据库未创建且迁移执行错误

核心问题定位 #

使用Tenancy for Laravel v3时，租户专属数据库未自动创建，执行tenants:migrate命令时误将迁移执行到中央数据库（导致users表已存在报错），且租户初始化后数据库连接未切换至租户库。

针对性修复步骤 #

1. 检查Tenancy配置文件 #

打开config/tenancy.php，确认数据库相关配置是否正确：

'database' => [
    // 租户默认连接需指向租户专属配置，而非中央库的mysql
    'default_connection' => 'tenant',
    'central_database_connection' => 'mysql', // 明确中央库连接名
    'connections' => [
        'tenant' => [
            'driver' => 'mysql',
            'host' => env('DB_HOST', '127.0.0.1'),
            'username' => env('DB_USERNAME', 'root'),
            'password' => env('DB_PASSWORD', ''),
            'database' => null, // 留空让系统自动生成租户库名
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
        ],
    ],
],

2. 确保Deployment模型符合Tenant契约要求 #

模型需实现Tenant接口并引入数据库处理Trait，同时定义租户库名生成规则：

use Illuminate\Database\Eloquent\Model;
use Stancl\Tenancy\Contracts\Tenant as TenantContract;
use Stancl\Tenancy\Database\Concerns\HasDatabase;

class Deployment extends Model implements TenantContract
{
    use HasDatabase;

    // 定义租户数据库名生成逻辑，确保唯一
    public function getDatabaseName(): string
    {
        return 'tenant_deployment_' . $this->id;
    }

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

3. 修正租户创建逻辑 #

控制器中需显式触发租户数据库创建，而非仅创建模型：

// 错误写法：仅创建模型，未初始化租户及数据库
// $deployment = Deployment::create($request->all());

// 正确写法：初始化租户并创建专属数据库
$deployment = Deployment::create($request->all());
$tenant = tenancy()->createTenant([
    'id' => $deployment->id, // 租户唯一标识
    // 其他租户属性
]);
$tenant->createDatabase(); // 显式创建租户数据库
// 可选：初始化租户连接，确保后续操作指向租户库
tenancy()->initialize($tenant);

4. 规范tenants:migrate命令执行 #

• 确保租户迁移文件存放于database/migrations/tenant目录（中央库迁移放根目录migrations）
• 执行命令时指定租户，避免误操作中央库：

# 单个租户迁移
php artisan tenants:migrate --tenant={租户ID}
# 所有租户批量迁移
php artisan tenants:migrate --all

5. 验证数据库用户权限 #

检查Laravel使用的数据库账号是否具备创建数据库的权限，登录MySQL执行：

GRANT CREATE, ALTER, DROP, SELECT, INSERT, UPDATE, DELETE ON *.* TO '你的数据库用户名'@'localhost';
FLUSH PRIVILEGES;

6. 日志验证连接切换 #

查看应用日志，确认租户初始化后连接是否切换：

[2024-XX-XX XX:XX:XX] local.INFO: Current database connection: tenant_deployment_1
（若仍显示mysql则未切换，需检查租户初始化逻辑）

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