Laravel多租户数据库凭证配置失败：无法创建连接并报1045错误

核心问题定位 #

SQLSTATE[HY000] [1045] 错误本质是数据库权限不足：执行Tenant::create()的主数据库用户，没有权限创建新数据库用户并分配权限；或是你指定的foo用户未提前创建且系统未自动生成，导致连接时被拒绝。

分步解决步骤 #

• 检查主数据库用户权限
  确保.env中DB_USERNAME对应的数据库用户拥有CREATE USER和GRANT权限。登录数据库执行命令验证：

  SHOW GRANTS FOR '你的主DB用户名'@'localhost';
  

  若缺少权限，执行授权命令：

  GRANT CREATE USER, GRANT OPTION ON *.* TO '你的主DB用户名'@'localhost';
  FLUSH PRIVILEGES;
  

• 修正租户用户创建逻辑
  既然需求是每个租户用独立数据库账号，不能直接指定未存在的foo/bar，需确保系统自动生成新用户并完成授权：

  1. 检查Tenant模型或多租户数据库管理器的逻辑，确认是否包含创建用户、分配租户数据库权限的代码。
  2. 若系统未自动处理，在租户创建事件中补充逻辑：

     use Illuminate\Support\Str;
     
     Tenant::created(function ($tenant) {
         // 生成唯一租户用户名（可根据租户ID/名称自定义规则）
         $tenantUsername = 'tenant_' . $tenant->id;
         $tenantPassword = Str::random(16); // 生成随机安全密码
     
         // 创建数据库用户
         DB::statement("CREATE USER ?@'localhost' IDENTIFIED BY ?", [
             $tenantUsername,
             $tenantPassword
         ]);
         // 仅授权该租户数据库的全权限
         DB::statement("GRANT ALL PRIVILEGES ON `{$tenant->database_name}`.* TO ?@'localhost'", [
             $tenantUsername
         ]);
         DB::statement('FLUSH PRIVILEGES');
     
         // 更新租户模型存储账号信息
         $tenant->update([
             'tenancy_db_username' => $tenantUsername,
             'tenancy_db_password' => $tenantPassword
         ]);
     });
     

• 调试连接失败细节
  临时添加日志查看实际执行的数据库操作：

  Tenant::creating(function ($tenant) {
      \Log::info('Tenant creation attempt: ', [
          'db_user' => $tenant->tenancy_db_username,
          'db_name' => $tenant->database_name ?? '未指定数据库名'
      ]);
  });
  

  查看storage/logs/laravel.log，同时检查数据库错误日志（如MySQL的error.log），确认是用户未创建还是权限不足导致的访问拒绝。

• 验证租户连接配置
  确保切换租户时，动态数据库连接的username和password参数正确读取租户模型中存储的账号信息，而不是沿用主连接的配置。

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