克隆Laravel项目安装依赖时因数据库查询触发运行时错误

问题根源 #

执行Composer install时，Laravel默认会触发post-autoload-dump脚本，其中包含php artisan package:discover命令。这个命令会初始化Laravel容器，加载所有注册的服务提供者（包括AppServiceProvider）并自动执行其boot()方法。而此时数据库尚未配置、甚至Sail的数据库容器还未启动，直接执行Category::all()这类数据库查询必然抛出驱动不存在的异常。

修复方案 #

方案1：给boot方法中的业务代码添加环境判断 #

在AppServiceProvider的boot()方法中，添加条件判断，只在非命令行环境、或排除特定命令时执行业务查询：

public function boot()
{
    // 仅在Web请求时执行，或排除package:discover等无需业务逻辑的命令
    $currentCommand = request()->server('argv')[1] ?? '';
    $skipCommands = ['package:discover', 'config:cache', 'config:clear'];
    
    if (!app()->runningInConsole() || !in_array($currentCommand, $skipCommands)) {
        $categories = Category::all()->where('active', true);
        // 后续使用$categories的业务代码
    }
}

方案2：将业务查询迁移到Web中间件（推荐） #

如果这段查询是用于给视图共享变量或仅在Web请求中生效的逻辑，建议将其从服务提供者迁移到Web专属中间件：

1. 创建中间件：

php artisan make:middleware ShareCategoriesMiddleware

2. 在中间件的handle()方法中编写查询逻辑：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\View;
use App\Models\Category;

class ShareCategoriesMiddleware
{
    public function handle($request, Closure $next)
    {
        $categories = Category::all()->where('active', true);
        View::share('categories', $categories);
        
        return $next($request);
    }
}

3. 在app/Http/Kernel.php的web中间件组中注册该中间件：

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

这样只有Web请求会触发该查询，命令行执行package:discover时完全不会触及这段代码，从根源避免冲突。

方案3：临时禁用Composer自动执行package:discover #

修改composer.json中的post-autoload-dump脚本，暂时注释掉package:discover命令：

"scripts": {
    "post-autoload-dump": [
        // "@php artisan package:discover --ansi",
        "@php artisan vendor:publish --force --tag=laravel-assets --ansi",
        "@php artisan optimize:clear"
    ]
}

执行composer install完成依赖安装后，恢复注释并手动执行：

php artisan package:discover --ansi

此方案适合临时应急，但需要手动操作，不推荐长期使用。

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