Laravel 8项目报错Unsupported driver [ecto]，驱动来源如何排查

问题原因定位 #

这个ecto驱动值100%来自Laravel运行时加载的数据库配置，你全局搜代码找不到是因为配置值没有硬编码在项目代码中，大概率是外部注入的运行时环境变量导致的。

排查步骤 #

• 首先排查运行时实际加载的配置，不要只检查本地代码文件。在项目根目录新建临时测试脚本config_test.php，内容如下：

<?php
require __DIR__.'/vendor/autoload.php';
$app = require_once __DIR__.'/bootstrap/app.php';
$app->make(Illuminate\Contracts\Console\Kernel::class)->bootstrap();

echo "默认数据库连接名：" . config('database.default') . PHP_EOL;
echo "队列使用的数据库连接名：" . config('queue.connections.database.connection') . PHP_EOL;
echo "所有数据库连接的驱动配置：" . PHP_EOL;
foreach (config('database.connections') as $connName => $connConfig) {
    echo "连接{$connName}的驱动：" . ($connConfig['driver'] ?? '未配置') . PHP_EOL;
}

执行命令php config_test.php查看输出，直接定位到底是哪个连接的配置被设为了ecto驱动。

• 检查运行环境的环境变量：
  • 先在当前执行命令的终端执行echo $DB_CONNECTION，看是不是shell全局设置了该环境变量
  • 如果是容器部署，检查容器启动参数、编排配置（如docker-compose.yml、K8s deployment的env字段），是否在启动时注入了DB_CONNECTION=ecto的变量，这类外部注入的优先级高于项目内的.env文件，不会出现在代码仓库中
• 手动清理配置缓存：直接删除bootstrap/cache/目录下所有.php后缀的缓存文件，避免config:clear命令未正常执行，同时如果开启了OPcache，重启PHP进程清空代码缓存
• 检查多环境配置文件：确认是否存在.env.${APP_ENV}这类分环境的隐藏env文件，这类文件如果在gitignore规则内，全局检索时可能会被遗漏
• 核对队列专属配置：打开config/queue.php查看database类型队列的connection参数，是否指定了不存在的自定义数据库连接

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