使用Symfony CLI与Docker执行数据库迁移时遇驱动未找到错误

核心排查方向：对齐本地CLI与Docker容器的环境配置 #

你遇到的问题大概率是本地Symfony CLI环境缺少数据库驱动，或者数据库连接配置未匹配Docker容器的服务设置。以下是具体解决步骤：

1. 修正数据库连接配置 #

检查项目根目录下的.env或.env.local文件，确保DATABASE_URL参数正确指向Docker容器内的数据库服务：

• 主机名需为docker-compose.yml中定义的数据库服务名（比如db，而非localhost）
• 端口号匹配容器暴露的端口（MySQL默认3306、PostgreSQL默认5432，需和docker-compose.yml的端口映射一致）
• 用户名、密码、数据库名要和容器启动时设置的环境变量完全匹配

示例MySQL配置：

DATABASE_URL="mysql://db_user:db_password@db:3306/db_name?serverVersion=8.0&charset=utf8mb4"

2. 在Docker容器内执行迁移命令（推荐方案） #

本地PHP环境通常未安装对应数据库驱动，直接进入容器内部执行命令更可靠：

• 先查看运行中的容器名：

docker ps

• 进入PHP容器（替换your-php-container为实际容器名）：

docker exec -it your-php-container bash

• 在容器内执行迁移操作：

php bin/console make:migration
php bin/console doctrine:migrations:migrate

3. 本地环境补充数据库驱动（若需本地执行） #

如果坚持在本地CLI运行命令，需为本地PHP安装对应数据库扩展：

• MySQL：安装pdo_mysql扩展
• PostgreSQL：安装pdo_pgsql扩展
  安装完成后重启PHP服务，再重新执行make:migration。

4. 验证数据库连通性 #

先执行以下命令测试数据库连接是否正常：

php bin/console doctrine:database:create --if-not-exists

若此命令报错，先通过docker-compose ps确认数据库容器是否正常运行，再检查容器间网络是否连通。

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