Laravel应用生产/沙箱数据库动态切换及用户表部署问题咨询

1. 实现数据库动态切换功能 #

通过「多连接配置+Session存储选择+中间件全局切换」的组合方案实现，具体步骤如下：

（1）配置多数据库连接 #

在config/database.php的connections数组中添加生产（production）和沙箱（sandbox）的数据库配置，示例：

'connections' => [
    // 可选：将用户认证库设为默认连接
    'mysql' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST', '127.0.0.1'),
        'database' => env('DB_DATABASE', 'auth_db'),
        'username' => env('DB_USERNAME', 'root'),
        'password' => env('DB_PASSWORD', ''),
        // 其他通用配置
    ],

    'production' => [
        'driver' => 'mysql',
        'host' => env('PROD_DB_HOST'),
        'database' => env('PROD_DB_NAME'),
        'username' => env('PROD_DB_USER'),
        'password' => env('PROD_DB_PWD'),
        // 其他通用配置
    ],

    'sandbox' => [
        'driver' => 'mysql',
        'host' => env('SANDBOX_DB_HOST'),
        'database' => env('SANDBOX_DB_NAME'),
        'username' => env('SANDBOX_DB_USER'),
        'password' => env('SANDBOX_DB_PWD'),
        // 其他通用配置
    ],
],

（2）存储用户的数据库选择 #

用户通过下拉菜单切换时，后端将选中的连接名存入Session，示例控制器方法：

// 处理数据库切换的控制器方法
public function switchDatabase(Request $request)
{
    $validated = $request->validate([
        'connection' => 'required|in:production,sandbox'
    ]);
    session(['db_connection' => $validated['connection']]);
    return redirect()->back();
}

（3）中间件全局切换数据库 #

创建中间件，在每个请求入口根据Session值切换默认数据库：

// app/Http/Middleware/SwitchDatabase.php
namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\DB;

class SwitchDatabase
{
    public function handle($request, Closure $next)
    {
        if ($connection = session('db_connection')) {
            DB::setDefaultConnection($connection);
        }
        return $next($request);
    }
}

在app/Http/Kernel.php的web中间件组中注册该中间件，确保所有前端请求都能触发切换：

protected $middlewareGroups = [
    'web' => [
        // 其他已有中间件
        \App\Http\Middleware\SwitchDatabase::class,
    ],
];

（4）前端切换UI #

在页面中添加下拉菜单，提交表单到切换接口即可，示例Blade代码：

<form action="{{ route('database.switch') }}" method="POST">
    @csrf
    <select name="connection" onchange="this.form.submit()">
        <option value="production" {{ session('db_connection') == 'production' ? 'selected' : '' }}>生产库</option>
        <option value="sandbox" {{ session('db_connection') == 'sandbox' ? 'selected' : '' }}>沙箱库</option>
    </select>
</form>

2. 用户表部署与表关联处理 #

（1）用户表的部署建议 #

优先选择新建独立的第三个数据库（如auth_db）存储用户表，核心原因：

• 分离认证数据与业务数据，切换业务数据库时不会影响用户登录状态和核心信息
• 避免生产/沙箱库的业务操作意外修改用户数据，提升数据安全性
• 跨库关联逻辑更清晰，无需在切换后频繁调整关联的数据库连接

若暂时不想新建库，也可将用户表放在生产库，但切换到沙箱库时，所有关联用户表的查询都需要跨库处理，长期维护成本较高。

（2）表关联处理 #

情况1：用户表在独立库

给User模型指定固定的数据库连接：

// app/Models/User.php
protected $connection = 'mysql'; // 对应config中的auth_db配置

业务模型（如Order）会随Session动态切换连接，关联用户表时明确指定用户表的连接即可：

// app/Models/Order.php
public function user()
{
    return $this->belongsTo(User::class, 'user_id')->setConnection('mysql');
}

情况2：用户表在生产库

切换到沙箱库时，业务模型需要指定用户表所在的生产库连接：

// app/Models/Order.php
public function user()
{
    $connection = session('db_connection') == 'sandbox' ? 'production' : config('database.default');
    return $this->belongsTo(User::class, 'user_id')->setConnection($connection);
}

这种方式需要在每个关联方法中判断当前连接，长期维护易出错，不推荐。

内容的提问来源于stack exchange，提问作者Donny Akhmad Septa Utama