Laravel 11：SQL模式初始化语句的最佳存储位置咨询

问题根源在于AppServiceProvider::boot()会在所有请求（包括命令行命令）启动时执行，而cache:clear这类命令不需要数据库连接就能运行，此时执行数据库语句必然会触发连接错误。以下是几个可行的解决方案：

方案1：通过数据库配置文件原生设置（推荐） #

Laravel支持在config/database.php的MySQL连接配置中直接添加PDO初始化命令，这是最原生可靠的方式，只会在建立数据库连接时执行：

找到mysql连接的配置数组，新增options项：

'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'unix_socket' => env('DB_SOCKET', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
    'options' => [
        PDO::MYSQL_ATTR_INIT_COMMAND => "SET sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'"
    ],
],

Laravel会在每次建立PDO连接时自动执行这条SQL，完全不会影响不需要数据库的命令。

方案2：监听数据库连接建立事件 #

利用Laravel的事件系统，只在数据库连接成功建立后执行SQL设置，避免无连接时触发：

在AppServiceProvider::boot()中注册事件监听：

use Illuminate\Database\Events\ConnectionEstablished;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\DB;

public function boot()
{
    Event::listen(ConnectionEstablished::class, function () {
        DB::statement("SET SESSION sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'");
    });
}

只有当数据库连接成功建立时，该事件才会触发，像cache:clear这类不涉及数据库的命令不会触发这段代码。

方案3：判断当前命令是否需要数据库（备选） #

如果一定要在ServiceProvider中处理，可以判断当前运行的命令是否属于无需数据库的类型，跳过执行：

use Illuminate\Support\Facades\DB;

public function boot()
{
    if (!$this->app->runningInConsole()) {
        DB::statement("SET SESSION sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'");
    } else {
        $skipCommands = ['cache:clear', 'config:cache', 'config:clear', 'route:clear', 'route:cache', 'view:clear'];
        $currentCommand = $_SERVER['argv'][1] ?? '';
        if (!in_array($currentCommand, $skipCommands)) {
            DB::statement("SET SESSION sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'");
        }
    }
}

这种方式需要手动维护跳过的命令列表，容易遗漏新的无数据库命令，仅作为备选方案。

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