Doctrine不提供开箱即用的连接重试机制，需通过PDO DSN配置connect_timeout和retry_interval参数（MySQL 8.0+支持）或手动封装try/catch重试逻辑实现。
Doctrine 连接重试不是开箱即用的功能
Doctrine 本身不提供连接失败后自动重试的机制，doctrine:database:create 或 ORM 查询报 Connection refused 时直接抛异常，不会重试。想实现重试，必须自己封装逻辑或借助底层驱动能力。
MySQL PDO 层面可配置 connect_timeout 和 retry_interval
真正起作用的是 PDO 的 MySQL DSN 参数，不是 Doctrine 配置项。在 .env 的 DATABASE_URL 中追加 &connect_timeout=10&retry_interval=2 即可生效（注意 URL 编码）：
mysql://user:pass@127.0.0.1:3306/dbname?serverVersion=8.0&connect_timeout=10&retry_interval=2
但要注意：
-
connect_timeout控制单次 TCP 连接超时（秒），不是重试次数 -
retry_interval是 MySQL 8.0+ 才支持的参数，表示重连间隔（秒），默认为 0（不重试） - 该机制只在初始连接时触发，查询过程中断开不会自动重连
- 若用 Docker 启动 MySQL，容器启动慢于 Symfony 应用，这个参数能缓解“Connection refused”
PHP 层手动重试更可控，适合生产环境
对关键操作（如命令行建库、初始化迁移），建议显式写重试逻辑，避免依赖底层不可靠行为：
for ($i = 0; $i < 3; $i++) {
try {
$this->get('doctrine.dbal.default_connection')->ping();
break;
} catch (\Exception $e) {
if ($i === 2) throw $e;
sleep(2);
}
}
常见使用场景：
-
doctrine:database:create命令前加健康检查 - CI 流水线中启动 MySQL 容器后等待连接就绪
- 部署脚本里调用
doctrine:migrations:migrate前确认 DB 可达
别把重试逻辑塞进 EntityRepository 或 Service 方法里——ORM 查询不该承担连接治理职责。
连接池和故障转移不在 Doctrine 默认能力范围内
如果真需要高可用（比如主从切换、多节点 fallback），Doctrine 不处理这些。得换方案：
- 用 ProxySQL 或 MaxScale 做数据库层路由
- 自定义
Connection类，继承Doctrine\DBAL\Connection，覆盖connect()方法实现多地址轮询 - 用
symfony/messenger+ 重试策略异步执行 DB 操作（仅适用非实时场景）
实际项目里，90% 的“重试需求”其实只是容器启动顺序问题，用 retry_interval + 简单 shell wait 就够了，过早引入复杂方案反而增加维护成本。
