symfony 4迁移连接超时本质是doctrine建连阶段卡住，须在doctrine.yaml的dbal.options中显式配置pdo::attr_timeout等参数，禁用database_url中的timeout伪配置，并修正docker环境host名、url编码及网络连通性。
Symfony 4 迁移过程中频繁出现连接超时，本质不是迁移命令本身慢，而是 Doctrine 在建立数据库连接阶段卡住——尤其在 Docker、云环境或网络不稳时。优化关键在于精准控制连接建立环节的等待时间，并排除基础设施干扰。
显式配置 PDO 连接超时参数
Doctrine 不从 DATABASE_URL 解析 timeout 类参数，必须在 config/packages/doctrine.yaml 的 dbal.options 中手动声明：
-
PDO::ATTR_TIMEOUT: 15—— 控制“尝试连上数据库”最多等 15 秒，对 MySQL 和 PostgreSQL 都生效 - 如果是 MySQL 8.0.3+ 且 php-mysqlnd 扩展可用，可加：
PDO::MYSQL_ATTR_READ_TIMEOUT: 30PDO::MYSQL_ATTR_WRITE_TIMEOUT: 30 - 值必须是整数（单位秒），不能写成
"15s"或带单位字符串
检查 DATABASE_URL 是否适配运行环境
本地开发连 Docker 数据库时，host 不能写 localhost：
- Docker 容器内 PHP 进程看到的
localhost是自己，不是宿主机上的数据库 - 应改用 Docker Compose 中定义的服务名，如
database或db - 确保
DATABASE_URL中密码不含@、/、:等特殊字符；如有，需 URL 编码（例如p@ss/word→p%40ss%2Fword）
确认底层扩展与网络可达性
连接超时常掩盖更底层的问题：
- 运行
php -m | grep pdo，确认已启用对应驱动（pdo_mysql或pdo_pgsql） - 在容器内执行
ping database或nc -zv database 5432，验证 DNS 解析和端口连通性 - 若用云数据库（如 AWS RDS、阿里云 PolarDB），检查安全组是否放行目标端口（3306 / 5432）
避免迁移期间 DB 服务未就绪
CI/CD 或容器启动时，migration 命令常早于数据库完全启动：
- 不要直接在
docker-compose up后立即跑doctrine:migrations:migrate - 加简单等待逻辑，例如：
until nc -z database 5432; do sleep 2; done && php bin/console doctrine:migrations:migrate - 或使用健康检查（healthcheck）配合 depends_on 的 condition: service_healthy
