Composer本身不直连MySQL，其post-install-cmd中执行的PHP脚本（如数据库迁移）因复用超时连接或PHP默认socket_timeout（60秒）早于MySQL wait_timeout而断开，需针对性修复连接复用、socket超时及连接池校验。
单纯调大 wait_timeout 不解决 Composer 场景下的 MySQL 连接断开问题——因为 Composer 本身不直连 MySQL，它只用 PHP 的 HTTP/CLI 网络能力下载包。你看到的“MySQL 断开”，实际是 Composer 执行的 PHP 脚本（比如 post-install-cmd 中的数据库迁移、缓存清空、配置写入）触发了 MySQL 连接超时，根源在脚本执行层，而非 Composer 自身。
Composer install 后执行 migration 报 Communications link failure
这是最典型的误判场景：你以为是 Composer 连接 MySQL 失败，其实是它调用的 PHP 命令（如 php artisan migrate 或 bin/console doctrine:migrations:migrate）里复用了旧连接，而该连接已在前一晚休眠超过 wait_timeout（默认 28800 秒）被 MySQL 主动关闭。
- 检查错误堆栈是否含
Communications link failure或The last packet successfully received from the server was X ms ago—— 这说明连接已失效，不是网络不通 - 确认该命令是否在长周期任务中复用 PDO 实例或 Doctrine EntityManager，而不是每次操作都新建连接
- 不要在 migration 脚本里依赖全局单例连接；改用
$em->getConnection()->ping()或显式 reconnect 逻辑
PHP CLI 默认 socket_timeout 比 MySQL wait_timeout 更早生效
PHP CLI 的 default_socket_timeout 默认为 60 秒，而 MySQL 的 wait_timeout 是 28800 秒。当 migration 执行耗时超过 60 秒（比如大表索引重建），PHP 层先中断 socket，报错 SQLSTATE[HY000]: General error: 2006 MySQL server has gone away，此时 MySQL 根本没来得及触发 wait_timeout。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时修复：运行命令时显式提高超时
php -d default_socket_timeout=300 artisan migrate - 永久修复：在
php.ini中设default_socket_timeout = 300（注意 CLI 和 FPM 配置文件可能不同） - 对比验证：执行
php -i | grep default_socket_timeout，确认 CLI 环境实际值
HikariCP / Doctrine DBAL 连接池未启用 idle-timeout 校验
如果你在 Composer post-install-cmd 中使用了基于连接池的 ORM（如 Doctrine DBAL + HikariCP），但没配置连接有效性检测，那么池中残留的“僵尸连接”会在首次使用时直接失败。
- 必须启用
connection-test-query（如SELECT 1）或connection-test-on-borrow = true - HikariCP 推荐配对设置：
idle-timeout = 300000（5 分钟） +max-lifetime = 1800000（30 分钟），确保连接在 MySQLwait_timeout前主动回收 - Doctrine DBAL 的
driverOptions中需显式传入PDO::ATTR_EMULATE_PREPARES => true，避免预编译语句在重连后失效
真正关键的不是让连接“活更久”，而是让应用层在连接失效前主动丢弃它——MySQL 的 wait_timeout 是兜底机制，不是容错策略；所有连接池和 ORM 都需要自己管理生命周期，不能指望数据库替你守着空闲连接。
