宝塔数据库连接 2002：区分 socket 和 TCP

故障现象或目标

程序报找不到 socket 或无法连接本地 MySQL。

原因与定位

PHP 客户端默认 socket 与 MySQL 实际位置不一致，或服务并未监听目标端口。

ss -lntp
mysql --protocol=TCP -h 127.0.0.1 -P 3306 -u <用户名> -p

处理方案

用显式 TCP 测试与 socket 测试对照。核对应用连接配置、实际端口和服务状态，再调整应用配置或对应 PHP 的 socket 路径。

验证与回退

使用应用真实账号完成连接，不把 root 本机登录成功当作应用验证。

修改前备份面板或站点对应配置。出现新异常时恢复本次改动，配置校验通过后再重载服务。不要覆盖其他站点或重导数据库。