PHP 8.4无法连接MySQL需依次检查：一、启用mysqli和pdo_mysql扩展并重载配置；二、校验php.ini中mysql.default_socket路径及扩展未被注释；三、确认MySQL运行、用户权限及认证插件为mysql_native_password；四、用test_db.php捕获真实错误；五、排查SELinux或防火墙拦截。
如果您在宝塔面板中使用PHP 8.4版本时无法连接MySQL数据库，则可能是由于扩展缺失、配置错误、权限限制或版本兼容性问题导致。以下是排查与修复该故障的具体操作步骤：
一、确认mysqli和pdo_mysql扩展已启用
PHP 8.4默认不自动启用MySQL相关扩展，需手动检查并启用mysqli及pdo_mysql模块，否则PHP脚本将无法建立任何MySQL连接。
1、登录宝塔面板，进入【软件商店】→ 找到已安装的PHP 8.4版本 → 点击【设置】。
2、切换至【安装扩展】选项卡，查找mysqli和pdo_mysql两项。
立即学习“PHP免费学习笔记（深入）”；
3、若状态为“未安装”，点击右侧【安装】按钮；若已显示“已启用”，请先点击【禁用】再重新【启用】以刷新加载状态。
4、安装/启用完成后，点击【重载配置】使扩展生效。
二、检查php.ini中MySQL相关配置项
部分PHP 8.4编译版本会忽略旧版php.ini中的mysql.default_socket等参数，需验证socket路径是否与MySQL实际运行路径一致，否则连接将超时或拒绝。
1、在PHP 8.4设置页面中，点击【配置文件】标签，打开php.ini编辑界面。
2、搜索关键词mysql.default_socket，确认其值与MySQL服务实际socket路径匹配（常见路径为/www/server/mysql/tmp/mysql.sock）。
3、若该行被注释（以分号开头），请删除分号；若路径错误，请修改为MySQL实际socket路径。
4、同时检查extension=mysqli和extension=pdo_mysql两行未被注释且位于extension列表中。
5、保存文件后，返回PHP设置页点击【重载配置】。
三、验证MySQL服务状态与用户权限
PHP连接失败可能源于MySQL服务未运行，或指定数据库用户无远程/本地连接权限，尤其PHP 8.4对认证插件更敏感，需确保用户使用mysql_native_password认证方式。
1、在宝塔【数据库】页面，确认目标MySQL实例状态为正在运行；若为停止状态，请点击【启动】。
Word报告自动生成神器。自动生成专业Word文档报告，支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。
2、点击对应数据库名右侧【管理】，进入phpMyAdmin或直接使用【终端】执行：SELECT User,Host,plugin FROM mysql.user WHERE User='your_db_user';
3、若plugin列为caching_sha2_password，请执行：ALTER USER 'your_db_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
4、执行FLUSH PRIVILEGES;刷新权限表。
5、如连接地址为127.0.0.1而非localhost，还需确认该用户Host字段包含127.0.0.1或%，否则连接被拒绝。
四、测试PHP连接脚本并捕获真实错误信息
使用最小化独立脚本绕过框架干扰，直接调用mysqli_connect()或PDO构造函数，可暴露底层错误码与提示，避免因错误抑制机制掩盖关键线索。
1、在网站根目录新建test_db.php文件，写入以下内容：
<?php $link = mysqli_connect("127.0.0.1", "用户名", "密码", "数据库名", 3306); if (!$link) { die("连接失败: " . mysqli_connect_error()); } echo "连接成功"; ?>
2、通过浏览器访问http://您的域名/test_db.php，记录完整报错信息（如“Connection refused”、“Access denied”、“Unknown MySQL server host”等）。
3、若报错含“SSL is required”，说明MySQL强制SSL连接，此时需在mysqli_connect第6参数传入数组：['ssl' => ['mode' => MYSQLI_CLIENT_SSL]]，或在MySQL中关闭require_secure_transport。
4、若报错为“Client does not support authentication protocol”，则必须执行第三步中的ALTER USER语句切换认证插件。
五、检查SELinux或防火墙拦截本地Socket通信
部分CentOS/RHEL系统启用SELinux后，默认策略会阻止PHP-FPM进程访问MySQL socket文件，即使路径正确、权限正常，连接仍静默失败。
1、执行命令getenforce确认SELinux当前状态，若返回Enforcing，则需临时设为Permissive验证是否为此原因：
2、执行：setenforce 0（仅临时生效），再运行test_db.php测试连接是否恢复。
3、若连接恢复正常，执行：ausearch -m avc -ts recent | grep mysqld查看拒绝日志，定位具体上下文。
4、永久放行需执行：setsebool -P httpd_can_network_connect_db 1，并确保MySQL socket所在目录上下文为mysqld_var_run_t（可用ls -Z /www/server/mysql/tmp/验证）。
