Symfony执行Doctrine迁移时错误使用PostgreSQL驱动的问题排查

错误现象 #

执行 doctrine:migration:migrate 命令时抛出错误：

An exception occurred in the driver: could not find driver

但日志显示Doctrine尝试使用PostgreSQL驱动（pdo_pgsql）连接，而非配置的MySQL：

[2025-01-16T10:40:02.752810+00:00] doctrine.INFO: Connecting with parameters array{"charset":"utf8","driver":"pdo_pgsql","host":"127.0.0.1","port":32769,"user":"app","password":"<redacted>","driverOptions":[],"defaultTableOptions":{"charset":"utf8mb4","collate":"utf8mb4_unicode_ci"},"dbname":"app","sslmode":"disable","serverVersion":"15.7"} {"params":{"charset":"utf8","driver":"pdo_pgsql","host":"127.0.0.1","port":32769,"user":"app","password":"<redacted>","driverOptions":[],"defaultTableOptions":{"charset":"utf8mb4","collate":"utf8mb4_unicode_ci"},"dbname":"app","sslmode":"disable","serverVersion":"15.7"}} []

当前配置 #

.env 文件（dev环境） #

APP_ENV=dev
DATABASE_URL="mysql://root:root@127.0.0.1:3317/docker_sf"

doctrine.yaml 配置 #

doctrine:
    dbal:
        url: '%env(resolve:DATABASE_URL)%'
        charset: utf8mb4
        logging: true
        default_table_options:
            charset: utf8mb4
            collate: utf8mb4_unicode_ci

原因分析 #

1. Symfony缓存未清除：Symfony会缓存环境变量和配置，旧的PostgreSQL配置可能被缓存，导致新的MySQL配置未生效。
2. 环境变量覆盖：存在其他环境配置文件（如.env.local、.env.dev.local），其中的DATABASE_URL覆盖了.env中的配置。
3. Docker容器配置冲突：如果使用Docker部署项目，容器内部可能加载了错误的环境变量，或者容器内的PHP未安装MySQL驱动。
4. 参数解析异常：%env(resolve:DATABASE_URL)% 解析出现问题，导致Doctrine未正确识别URL中的MySQL协议。

解决步骤 #

1. 清除Symfony缓存
   执行命令清除dev环境缓存：

   php bin/console cache:clear --env=dev
   

   生产环境可添加--no-warmup参数：

   php bin/console cache:clear --env=prod --no-warmup
   

2. 检查覆盖性环境文件
   查看项目根目录下是否存在.env.local、.env.dev.local等文件，这些文件优先级高于.env，若其中定义了PostgreSQL的DATABASE_URL，需修改或删除该配置。

3. 验证环境变量加载
   执行命令查看当前生效的DATABASE_URL：

   php bin/console debug:container --env-var=DATABASE_URL
   

   确认输出为MySQL协议（mysql://开头），而非PostgreSQL的pgsql://。

4. 检查PHP驱动安装

   • Windows：在php.ini中启用extension=pdo_mysql和extension=mysqli，重启服务器。
   • Linux（Debian/Ubuntu为例）：执行命令安装MySQL驱动：

     sudo apt-get install php-mysql
     

     安装后重启PHP-FPM或Apache/Nginx。

5. Docker环境排查

   • 检查docker-compose.yml中是否设置了错误的环境变量，确保容器内的DATABASE_URL与本地配置一致。
   • 确认Docker镜像中安装了MySQL驱动，可在Dockerfile中添加：

     RUN apt-get update && apt-get install -y php-mysql
     

内容的提问来源于stack exchange，提问作者Manuel Prieto macías