Laravel不使用database.php直接连接数据库报错解决

问题原因 #

你当前的代码报错是因为on()方法仅接受数据库连接名称字符串，而非直接传入配置数组。Laravel内部会对传入的参数执行字符串相关操作（比如str_ends_with），因此传入数组时会触发类型错误。

正确实现方式 #

要在不修改database.php的前提下临时连接外部数据库，需先通过Config facade动态注册一个临时连接配置，再使用该连接名称进行查询：

use Illuminate\Support\Facades\Config;
use App\Models\Mesa;
use Exception;

public function prueba()
{
    try {
        // 定义临时连接的名称
        $tempConnection = 'external_temp_db';
        
        // 动态设置临时连接的完整配置
        Config::set("database.connections.$tempConnection", [
            'driver' => 'mysql',
            'host' => '127.0.0.1',
            'port' => '3306',
            'database' => 'mydatabase_laravel',
            'username' => 'root',
            'password' => '',
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'unix_socket' => env('DB_SOCKET', ''),
            'prefix' => '',
            'strict' => true,
        ]);

        // 使用临时连接执行Eloquent查询
        $data = Mesa::on($tempConnection)->get();
        
        // 可选：若后续不再使用该临时连接，可清理配置
        // Config::forget("database.connections.$tempConnection");
        
        return $data;
    } catch (Exception $e) {
        error_log($e->getMessage());
        return Responses::errorHttpXWithoutErrors(500, '查询外部数据库时发生错误');
    }
}

替代方案（直接使用Query Builder） #

如果不需要依赖Eloquent模型，也可以直接通过DB::connection()传入配置数组创建临时连接：

use Illuminate\Support\Facades\DB;
use Exception;

public function prueba()
{
    try {
        $data = DB::connection([
            'driver' => 'mysql',
            'host' => '127.0.0.1',
            'port' => '3306',
            'database' => 'mydatabase_laravel',
            'username' => 'root',
            'password' => '',
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
        ])->table('mesas')->get();
        
        return $data;
    } catch (Exception $e) {
        error_log($e->getMessage());
        return Responses::errorHttpXWithoutErrors(500, '查询外部数据库时发生错误');
    }
}

这种方式无需提前注册连接配置，直接传入数组即可生成临时连接实例。

内容的提问来源于stack exchange，提问作者Yeimer Rafael Montes Mendoza