Laravel配置MySQL+PostgreSQL双库时提示找不到pgsql驱动
pgsql连接报"找不到驱动"的排查修复
报错Illuminate\Database\QueryException could not find driver的核心原因非常明确:当前承载Web服务的PHP运行进程,没有实际加载可用的pdo_pgsql扩展,问题和Laravel层面的账号、库名配置没有关系。可以按照下面的步骤逐一排查:
1. 优先排查多环境配置不匹配的问题
这是90%同类问题的根源:
- 不要只凭文件路径确认改对了php.ini,直接在项目的
public目录下新建临时文件info.php,写入如下代码:
<?php phpinfo();
- 直接通过浏览器访问这个info文件,不要用CLI运行这个脚本
- 在输出的phpinfo页面核对两个关键信息:
- 找到
Loaded Configuration File项,确认这个路径指向的php.ini,就是你之前取消pgsql、pdo_pgsql扩展注释的文件。很多开发者本地装了多个PHP版本,或者同时搭配了Apache、Nginx+PHP-FPM,修改的是CLI或者Apache对应的php.ini,但是Web服务实际绑定的是另一个PHP运行环境,就会出现命令行能连接pgsql、Web进程却找不到驱动的矛盾情况 - 全局搜索页面内容,看
PDO drivers行的列表里有没有pgsql,如果没有,就说明当前Web用的PHP根本没有加载到这个扩展
- 找到
- 交叉验证:在项目根目录执行命令
php -m | grep pgsql,如果命令行能输出pgsql相关扩展,但是浏览器访问的phpinfo里没有,就100%是两个运行环境的配置不匹配
2. 排除代码层面的低级书写错误
哪怕数据库连接正常,你现有代码里已经存在会导致后续运行报错的问题:
- 控制器类名书写错误:
class Thepage Controller extends Controller中间存在空格,PHP类名不允许包含空格,修改为class ThepageController extends Controller,否则路由匹配到这个控制器时会直接触发语法解析错误 - 你的
.env里配置的DB_CONNECTION_SECOND=pgsql属于未被代码引用的冗余配置,不会影响运行,但可以删掉避免配置混乱 - pgsql连接配置里的
url => env('DATABASE_URL'),如果当前服务器环境存在全局的DATABASE_URL环境变量,Laravel会优先解析这个url而忽略下面的host、port等配置。等驱动问题解决后如果报连接错误,可以临时把这行注释掉再测试
3. 扩展加载异常的剩余排查点
如果phpinfo里已经能看到pgsql驱动,但是还是报找不到驱动,检查下面两个点:
- 扩展版本和PHP版本不匹配:Windows环境下如果下载的
pdo_pgsql.dll是其他PHP版本编译的(比如把PHP8.1的扩展装到PHP8.2环境),会因为版本不兼容被PHP静默忽略,不会在启动时报明显错误,需要下载对应PHP版本、对应线程安全/非线程安全版本的扩展文件 - 依赖库缺失:Windows环境下pgsql扩展依赖
libpq.dll,需要把PHP安装目录下的这个文件放到系统System32目录,或者PHP的运行根目录,不然扩展加载了也会因为依赖缺失无法被识别 - 所有配置调整完成后,执行
php artisan config:clear清除配置缓存,避免旧的缓存内容导致新配置不生效
内容的提问来源于stack exchange,提问作者Mostafa Safarian
相关产品推荐
相关产品推荐

