Doctrine MySQL连接超时需同时配置客户端connect_timeout和服务端wait_timeout：前者通过DATABASE_URL或driverOptions设置socket连接超时，后者须在MySQL中设为300秒并配合Doctrine的ping_sql或idle_timeout（建议270秒）确保连接有效性。
Doctrine MySQL 连接超时参数怎么加
Doctrine 默认不启用连接超时，connect_timeout 和 wait_timeout 必须显式传给底层 PDO，不能只靠 DATABASE_URL 基础字段。超时控制分两层：建立连接阶段（socket 级）和连接后空闲等待阶段（MySQL server 级），两者都要设，否则仍可能卡住。
-
DATABASE_URL中加connect_timeout=10和wait_timeout=60—— 但注意这只是传递给 PDO 的 DSN 参数，不是所有驱动都识别；MySQL 驱动支持，PostgreSQL 不支持 - 更可靠的方式是在
config/packages/doctrine.yaml的doctrine.dbal.options下注入driverOptions：
doctrine:
dbal:
options:
1002: 'SET NAMES utf8mb4' # 这是 charset 指令，不是超时
1003: 10 # PDO::ATTR_TIMEOUT = 10 秒（PHP 8.1+ 才真正生效）
但实际中，PDO::ATTR_TIMEOUT 在 MySQL 驱动里常被忽略，真正起效的是 socket 层的 connect_timeout 和 MySQL server 自身的 wait_timeout。
为什么 connect_timeout=5 有时不起作用
常见现象：改了 DATABASE_URL="mysql://u:p@127.0.0.1:3306/db?connect_timeout=5"，但网络断开时命令仍卡 30 秒以上。这是因为：
- MySQL 客户端库（libmysqlclient 或 mysqlnd）对
connect_timeout的解释不同：mysqlnd 会严格遵守，libmysqlclient 可能 fallback 到系统 TCP 超时（Linux 默认 21 秒） - 如果用的是 Docker 或远程 IP，DNS 解析失败也会绕过
connect_timeout，先卡在 resolver 上 - Symfony 的
doctrine:database:create或doctrine:schema:update是 CLI 命令，它们启动时若 DNS 不通或防火墙拦截，PDO 构造函数本身就会阻塞，不走 DSN 参数解析逻辑
如何验证超时是否生效
别依赖日志或命令返回时间 —— 那些是 Symfony 包装后的表现，底层 PDO 错误码才真实。运行这个最小验证脚本：
<?php
$dsn = 'mysql:host=127.0.0.1;port=3307;dbname=test;connect_timeout=3';
try {
$pdo = new PDO($dsn, 'user', 'pass', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_TIMEOUT => 3,
]);
} catch (PDOException $e) {
echo $e->getCode(), ': ', $e->getMessage();
}
把 port 改成一个没监听的端口（如 3307），观察是否 3 秒内报错 SQLSTATE[HY000] [2003] Can't connect to MySQL server。如果不是，说明超时没生效，得查 PHP 编译时用的是 mysqlnd 还是 libmysqlclient。
生产环境必须配的两个超时组合
光设 connect_timeout 不够，MySQL server 端默认 wait_timeout=28800（8 小时），长连接空闲太久会被 kill，而 Doctrine 连接池不会自动重连 —— 导致后续请求直接抛 MySQL server has gone away。
- 在 MySQL 配置里设
wait_timeout = 300（5 分钟），同时设interactive_timeout = 300 - 在 Doctrine 配置里加心跳检测：
doctrine.dbal.ping_sql: "SELECT 1"（Symfony 5.3+ 支持），它会在每次从连接池取连接前执行该语句，失败则丢弃并新建 - 旧版 Symfony 5.0 没
ping_sql，只能靠doctrine.dbal.idle_timeout（单位秒），设为比wait_timeout小 30 秒，比如 270
最易被忽略的是 idle_timeout 和 wait_timeout 的差值 —— 差太小会频繁重建连接，差太大则必然遇到 gone away 错误，这个窗口期必须手动对齐。
