Laravel安装脚本运行时如何禁用数据库连接检查？

针对你遇到的迁移前数据库为空导致的SQLSTATE[42S02]错误，可以通过以下方式实现“未安装时禁用数据库连接检查”的逻辑：

1. 用环境变量标记安装状态 #

在.env文件中新增一个标记项，初始值设为未安装：

APP_INSTALLED=false

待安装脚本执行完成后，再将其改为true。

2. 在服务提供者中拦截数据库连接逻辑 #

编辑app/Providers/AppServiceProvider.php，在boot方法开头加入判断，未安装时阻止Laravel自动触发数据库相关操作：

public function boot()
{
    if (!env('APP_INSTALLED', false)) {
        // 禁用Eloquent模型的启动逻辑，避免触发数据库连接
        $this->app->bind(\Illuminate\Database\Eloquent\Model::class, function () {
            return new class extends \Illuminate\Database\Eloquent\Model {
                public static function boot()
                {
                    // 空实现，跳过默认的模型启动流程
                }
            };
        });

        // 禁用数据库连接的事件分发，避免执行连接检查
        $this->app->resolving('db', function ($db) {
            $db->getConnection()->setEventDispatcher(new \Illuminate\Events\NullDispatcher);
        });
    }
}

3. 编写独立的安装脚本入口 #

新建一个独立的安装入口文件（比如public/install.php），不经过Laravel的web中间件组，避免中间件触发数据库操作：

<?php
require __DIR__.'/../vendor/autoload.php';
$app = require_once __DIR__.'/../bootstrap/app.php';

// 检查是否已安装
if (env('APP_INSTALLED', false)) {
    die('应用已完成安装');
}

// 创建目标数据库（如果需要）
$dbConfig = $app['config']['database.connections.mysql'];
$rootConnection = $app->make('db')->connection([
    'driver' => 'mysql',
    'host' => $dbConfig['host'],
    'port' => $dbConfig['port'],
    'database' => '',
    'username' => $dbConfig['username'],
    'password' => $dbConfig['password'],
]);
$rootConnection->statement("CREATE DATABASE IF NOT EXISTS `{$dbConfig['database']}`");

// 执行数据库迁移
$app->make(\Illuminate\Contracts\Console\Kernel::class)->call('migrate', ['--force' => true]);

// 更新.env文件，标记安装完成
$envPath = base_path('.env');
file_put_contents(
    $envPath,
    str_replace('APP_INSTALLED=false', 'APP_INSTALLED=true', file_get_contents($envPath))
);

echo '应用安装成功！';

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