MySQL连接失败主因有四：socket路径不匹配、连接池与配置未协同、PHP扩展未启用、防火墙/SELinux权限拦截；需逐项检查并同步调整配置与服务状态。
MySQL 连接被拒绝：先看 socket 文件路径是否匹配
宝塔面板里新建站点连不上数据库，报错类似 Can't connect to local MySQL server through socket '/tmp/mysql.sock'，大概率不是密码错了，而是 PHP 或应用读取的 socket 路径和 MySQL 实际监听的不一致。
MySQL 在宝塔中默认用的是 /www/server/data/mysql.sock，但很多 PHP 扩展（尤其是编译安装或旧版本）仍硬编码了 /tmp/mysql.sock。PHP 的 mysqli.default_socket 和 PDO_mysql.default_socket 配置项必须显式指向正确路径。
- 查 MySQL 实际 socket 路径：
mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" - 改 PHP 配置：在宝塔 → PHP 设置 → 配置文件中，添加或修改两行：
mysqli.default_socket = /www/server/data/mysql.sock<br>PDO_mysql.default_socket = /www/server/data/mysql.sock
- 改完重启 PHP 服务，不要只重载 —— 宝塔里点“重启”而非“重载配置”
连接池耗尽导致超时：max_connections 和应用层复用要一起调
网站访问量稍大就出现 Too many connections 或连接卡住几秒才响应，光调 MySQL 的 max_connections 不够。宝塔默认设为 151，对 Laravel、ThinkPHP 等框架 + PDO 长连接场景远远不够，且应用没主动 close，连接会堆积在池里不释放。
关键不在“最大值”，而在“连接生命周期”。PHP-FPM 的 pm.max_children 和 MySQL 的 max_connections 要按比例配平，否则不是 PHP 进程等不到连接，就是 MySQL 被撑爆。
- 查当前连接数：
show status like 'Threads_connected'; - 临时调高 MySQL 限制（仅测试）：
SET GLOBAL max_connections = 500;，再写入/etc/my.cnf的[mysqld]段持久化 - Laravel 用户注意：.env 中
DB_PERSISTENT=true会启用持久连接，若未配好连接池回收策略，比短连接更容易占满
宝塔 PHP 扩展缺失导致 mysqli 或 PDO 报错
错误信息里带 Call to undefined function mysqli_connect() 或 Class 'PDO' not found，不是数据库挂了，是 PHP 根本没加载对应扩展。宝塔安装 PHP 时勾选“全选”不等于全装上 —— 某些版本（如 PHP 8.2）的 mysqli 是单独编译模块，默认不启用。
尤其容易忽略的是：不同 PHP 版本（如 7.4 和 8.1）的扩展开关是独立的，切换了站点 PHP 版本后，得重新进对应版本的“设置 → 安装扩展”里确认勾选。
- 进宝塔 → 软件商店 → 找到对应 PHP 版本 → 点“设置” → “安装扩展”
- 确保
mysqli和PDO两个选项已打勾（PDO 还要顺带确认PDO MySQL子项） - 改完必须点“重载配置”，部分版本还需点一次“重启”才生效
防火墙与 SELinux 干扰本地 socket 连接
明明 socket 路径对、扩展开了、参数也配了，还是连不上，且错误变成 Permission denied 或直接无响应，就要怀疑系统级权限拦截。宝塔在 CentOS 7/8 上默认关 SELinux，但某些一键脚本或手动装过安全加固工具的机器可能开着；Ubuntu 的 ufw 有时也会误拦本地 Unix socket。
Unix domain socket 虽然走本地，但文件权限和上下文标签（SELinux）照样起作用。MySQL sock 文件属主是 mysql:mysql，而 PHP-FPM 进程通常以 www 用户运行 —— 如果 /www/server/data/ 目录权限太严（比如 700），www 用户根本进不去目录，更别说访问 sock 文件。
- 检查 socket 文件权限：
ls -l /www/server/data/mysql.sock，确保所在目录至少对组可读执行（如 750），且www用户在mysql组里（或直接 chmod 755 目录） - 临时关 SELinux 测试：
setenforce 0；永久关闭需改/etc/selinux/config - Ubuntu 用户检查：
sudo ufw status，若为 active，尝试sudo ufw disable排查
Socket 路径错、连接池没协同、扩展没启、权限卡死——这四类问题覆盖了宝塔环境下 90% 的数据库连接失败。真正难排查的，往往是其中两项叠加，比如改了 socket 路径却忘了重启 PHP，或者调高了 max_connections 却没同步调 pm.max_children。
