PHP8.4在宝塔面板中MySQL长连接失效需五步修复：一、启用mysqlnd扩展并配置mysqli.allow_persistent=On；二、修改php.ini强制开启持久化参数；三、Nginx配置fastcgi_keep_conn on；四、PHP-FPM改用Unix socket监听并调优进程数；五、代码层使用mysqli_pconnect()或PDO::ATTR_PERSISTENT=true并验证连接复用。
如果您在宝塔面板中启用PHP8.4后发现MySQL长连接（persistent connection）失效，表现为PDO或mysqli_pconnect无法复用连接、频繁新建TCP连接、连接数飙升或出现“Too many connections”错误，则可能是由于PHP8.4默认禁用持久连接机制或相关配置未同步生效。以下是恢复PHP8.4持久连接的具体操作步骤：
一、检查并启用PHP8.4的持久连接支持
PHP8.4移除了部分旧版持久化逻辑，需确认其编译时启用了mysqlnd扩展且未禁用持久连接能力。该步骤用于验证基础支持状态，并修正缺失配置。
1、登录宝塔面板，进入【软件商店】→ 找到已安装的【PHP8.4】→ 点击【设置】→ 切换至【配置修改】选项卡。
2、在配置文件中搜索 mysqlnd，确认存在 extension=mysqlnd 或类似行；若无，请手动添加至 [php] 段落末尾。
立即学习“PHP免费学习笔记（深入）”；
3、继续查找 mysqli.allow_persistent 与 pdo_mysql.default_socket 两项，确保其值分别为 On 与 /tmp/mysql.sock（路径需与实际MySQL socket一致）。
4、保存配置后，点击【重载配置】按钮使更改生效。
二、修改php.ini强制启用持久化参数
部分PHP8.4二进制包在构建时将持久连接设为默认关闭，需通过php.ini显式开启关键开关，否则mysqli_pconnect()和PDO::ATTR_PERSISTENT将被忽略。
1、在【PHP8.4设置】→ 【配置修改】中，定位到 ;mysqli.allow_persistent = On 行，删除开头分号使其激活。
2、查找 ;mysqlnd.collect_statistics = On，同样取消注释以启用连接池统计功能。
3、新增以下三行（如不存在）：
mysqli.reconnect = On
pdo_mysql.cache_size = 2000
mysqlnd.net_cmd_buffer_size = 65536
4、保存并重启PHP8.4服务。
三、调整Nginx FastCGI参数适配长连接
Nginx与PHP-FPM之间若使用短连接模式，会阻断PHP内部的持久连接复用链路。必须确保FastCGI请求复用底层TCP连接，才能让PHP8.4的持久化机制真正生效。
1、进入【网站】→ 选择对应站点 → 【配置文件】→ 在 location ~ \.php$ 块内查找 fastcgi_pass 行。
2、在其下方添加以下两行：
fastcgi_keep_conn on;
fastcgi_read_timeout 300;
3、保存配置，然后执行 nginx -t && nginx -s reload 验证并重载。
四、替换PHP-FPM监听方式为socket并启用连接池
使用TCP监听（127.0.0.1:9000）易受TIME_WAIT堆积影响，导致PHP-FPM无法维持稳定长连接上下文；改用Unix socket可绕过网络栈，提升持久连接稳定性。
1、进入【PHP8.4设置】→ 【服务】→ 点击【停止】后再点击【设置】→ 切换至【PHP-FPM设置】选项卡。
2、将 监听端口 改为 unix:/tmp/php-cgi-84.sock（路径须与 /www/server/php/84/etc/php-fpm.d/www.conf 中 listen 项完全一致）。
3、在同页面找到 最大子进程数，设为 32；将 最大空闲进程数 设为 16，以保障连接池容量。
4、保存并重启PHP8.4服务。
五、验证MySQL客户端层持久连接行为
即使PHP配置正确，若应用代码未显式启用持久连接或使用了不兼容语法，仍会导致长连接失效。此步骤聚焦于代码调用层的合规性校验。
1、检查PHP代码中是否使用 mysqli_pconnect() 而非 mysqli_connect()；对于PDO，确认实例化时传入 [PDO::ATTR_PERSISTENT => true]。
2、在连接建立后，立即执行SQL：SHOW STATUS LIKE 'Threads_connected';，连续刷新多次，观察数值是否稳定在较低水平（如2–5），而非随每次请求递增。
3、登录MySQL命令行，执行：SELECT * FROM performance_schema.threads WHERE TYPE='FOREGROUND' AND PROCESSLIST_COMMAND='Sleep';，确认存在长时间存活（>60秒）且PROCESSLIST_STATE为"Waiting for table metadata lock"以外状态的线程。
