“mysql server has gone away”错误主因是连接空闲超时、数据包过大或服务端异常，需调高wait_timeout、禁用持久连接、主动重连、拆分大查询并检测心跳。
PHP8应用在执行数据库操作中途突然报“MySQL server has gone away”或“Lost connection to MySQL server during query”，说明连接已被服务端主动断开，不是代码写错，而是连接空闲超时、数据包过大或服务端异常重启导致。
检查并延长MySQL服务端wait_timeout
MySQL默认wait_timeout为28800秒（8小时），但某些云数据库（如阿里云RDS）会设为300秒甚至更短——只要PHP脚本中一次查询耗时超过该值，或连接建立后5分钟内没发任何请求，连接就被强制关闭。
登录MySQL执行：SHOW VARIABLES LIKE 'wait_timeout';
若返回值≤300，需调整：执行SET GLOBAL wait_timeout = 28800;（需SUPER权限）；生产环境应同步修改my.cnf，在[mysqld]段追加wait_timeout = 28800并重启MySQL。
【注意：仅对新连接生效，已存在的Sleep连接仍会在原timeout后断开】
PHP层主动检测并重连
PDO本身不自动重连，必须由代码显式判断连接状态并在失败时重建实例。
方法一：用try/catch捕获异常后new PDO
在执行关键查询前加一层防护：
if (!$pdo || $pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS) === false) { $pdo = new PDO($dsn, $user, $pass, $options); }
方法二：封装安全查询函数（推荐）
把所有$pdo->query()调用替换为自定义safeQuery($sql)函数，内部先try { $pdo->query("SELECT 1"); }心跳检测，失败则重建连接再执行原SQL。这一步必须做，否则前端偶发500错误无法避免。
禁用持久连接，改用短连接
PHP 8+下PDO持久连接（PDO::ATTR_PERSISTENT => true）在FPM子进程中极易引发连接泄漏：子进程退出时连接不真正关闭，MySQL持续显示Sleep状态，最终触发max_connections上限而拒绝新连接。
第一步：检查database配置中是否含'persistent' => true或'params' => [PDO::ATTR_PERSISTENT => true]
第二步：全部改为false或直接删除该配置项
第三步：确认phpinfo()中“PDO Drivers”显示mysql，且“Client API version”与MySQL服务端版本兼容（如MySQL 8.0.33需PHP 8.1+）
拆分大查询，避免packets exceeded
当执行INSERT大量数据或SELECT超长TEXT字段时，可能触发MySQL的max_allowed_packet限制（默认4MB），报错“Got a packet bigger than ‘max_allowed_packet’ bytes”，表面是连接中断，实为单包被拒。
查当前值：SHOW VARIABLES LIKE 'max_allowed_packet';
临时调高（需重启后永久生效）：SET GLOBAL max_allowed_packet = 64*1024*1024;
更稳妥做法是：在PHP中把大INSERT拆成每次1000行的批次→用INSERT INTO t VALUES (),(),()...批量插入→每批执行后unset($stmt)释放资源→避免单次内存暴涨触发OOM或超时。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
