Laravel中根据访问URL切换主数据库连接的实现咨询

架构老林

2026-4-20

嗨，针对你的问题，我来详细给你拆解下：

首先明确回答你：你确实可以在config/database.php里根据当前URL修改数据库连接配置，但这种做法真的不推荐。原因很简单：Laravel的配置文件会在应用启动时被加载，如果你执行了php artisan config:cache缓存配置，那里面的条件判断只会执行一次，后续请求不会再重新判断；而且把请求相关的逻辑混到配置文件里，也不符合Laravel的设计原则，还会导致控制台命令（比如 artisan 命令、定时任务）出现报错，因为这些场景下request()实例根本不存在。

不过如果你非要尝试这种方式，具体写法可以参考下面的代码：
在config/database.php的connections数组中，修改你的主数据库连接（比如mysql）：

'mysql' => [
    'driver' => 'mysql',
    'host' => request()->getHost() === 'a.mycompany.com' ? env('DB_HOST_A') : env('DB_HOST_B'),
    'database' => request()->getHost() === 'a.mycompany.com' ? env('DB_DATABASE_A') : env('DB_DATABASE_B'),
    'username' => request()->getHost() === 'a.mycompany.com' ? env('DB_USERNAME_A') : env('DB_USERNAME_B'),
    'password' => request()->getHost() === 'a.mycompany.com' ? env('DB_PASSWORD_A') : env('DB_PASSWORD_B'),
    // 其他通用配置项（比如端口、字符集等）保持不变
],

再次强调：这种写法不能缓存配置，而且在非HTTP请求场景（比如命令行）会直接报错，所以非常不建议在生产环境使用。

更推荐的标准实现方式

下面是符合Laravel最佳实践的做法，步骤清晰且稳定：

先配置两个独立的数据库连接
在config/database.php的connections数组里，添加两个不同的连接配置：

'connections' => [
    // 原有的其他连接...
    'mysql_a' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST_A'),
        'database' => env('DB_DATABASE_A'),
        'username' => env('DB_USERNAME_A'),
        'password' => env('DB_PASSWORD_A'),
        'port' => env('DB_PORT', '3306'),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'strict' => true,
        'engine' => null,
    ],
    'mysql_b' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST_B'),
        'database' => env('DB_DATABASE_B'),
        'username' => env('DB_USERNAME_B'),
        'password' => env('DB_PASSWORD_B'),
        'port' => env('DB_PORT', '3306'),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'strict' => true,
        'engine' => null,
    ],
],

记得在.env文件里添加对应的环境变量：

DB_HOST_A=xxx.xxx.xxx.xxx
DB_DATABASE_A=db_a
DB_USERNAME_A=user_a
DB_PASSWORD_A=pass_a

DB_HOST_B=xxx.xxx.xxx.xxx
DB_DATABASE_B=db_b
DB_USERNAME_B=user_b
DB_PASSWORD_B=pass_b

创建中间件处理连接切换
生成一个新的中间件：

php artisan make:middleware SwitchDatabaseMiddleware

然后打开app/Http/Middleware/SwitchDatabaseMiddleware.php，修改handle方法：

<?php

namespace App\Http\Middleware;

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

class SwitchDatabaseMiddleware
{
    public function handle($request, Closure $next)
    {
        // 获取当前访问的域名
        $currentHost = $request->getHost();
        
        // 根据域名切换默认数据库连接
        switch ($currentHost) {
            case 'a.mycompany.com':
                DB::setDefaultConnection('mysql_a');
                break;
            case 'b.mycompany.com':
                DB::setDefaultConnection('mysql_b');
                break;
            // 可以添加更多域名的判断
            default:
                // 默认使用原来的主连接，或者抛出异常
                DB::setDefaultConnection('mysql');
                break;
        }
        
        return $next($request);
    }
}

注册中间件
打开app/Http/Kernel.php，把这个中间件添加到web中间件组里（这样所有网页请求都会经过这个中间件）：

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

如果只需要特定路由切换数据库，也可以把中间件注册为路由中间件，然后在路由里单独调用。

这种做法的优势很明显：

完全符合Laravel的设计规范，逻辑和配置分离
不受配置缓存影响，因为中间件是在请求处理阶段执行的
兼容控制台命令场景，命令里可以手动指定连接，不会冲突
扩展性强，后续新增域名只需要添加新的连接配置和中间件判断即可

最后补充一点：如果你有个别模型需要固定使用某个数据库连接，可以在模型类里直接指定$connection属性，比如：

class User extends Model
{
    protected $connection = 'mysql_a';
}

这样这个模型就不会受默认连接切换的影响。

备注：内容来源于stack exchange，提问作者TKoL

Laravel中根据访问URL切换主数据库连接的实现咨询

更推荐的标准实现方式 #

更推荐的标准实现方式