MySQL服务未启动是宝塔“无法连接数据库”的最常见原因，需依次检查systemctl状态、错误日志、socket路径及用户权限。
MySQL 服务根本没启动
宝塔面板显示“无法连接数据库”，最常见原因是 mysqld 进程压根没跑起来，不是密码错、端口占、权限问题，就是服务停了。执行 systemctl status mysqld 或 service mysql status（不同系统命令略有差异），看输出里有没有 active (running)。如果显示 inactive (dead) 或直接报 Unit mysqld.service not found，说明服务未安装或未启用。
- CentOS 7/8 默认用
mysqld，但宝塔可能装的是mysql；Ubuntu/Debian 通常用mysql，试下systemctl status mysql - 刚装完宝塔没重启过机器？有些版本 MySQL 不会自动开机自启，手动运行
systemctl enable mysqld && systemctl start mysqld - 如果提示
Failed to start mysqld.service: Unit not found，说明 MySQL 没装成功——宝塔安装日志在/www/wwwlogs/install.log，搜mysql关键字看卡在哪步
MySQL 启动失败但看不出原因
执行 systemctl start mysqld 后立刻失败，systemctl status mysqld 只显示 “failed” 且日志不具体，这时候得看 MySQL 自己的日志。默认路径是 /www/server/data/*.err（比如 /www/server/data/vm-xxx.err），错误最密集的地方往往在文件末尾。
- 常见报错
Can't start server: Bind on TCP/IP port. Got error: 98: Address already in use→ 端口被占，查netstat -tlnp | grep :3306 - 报
InnoDB: The Auto-extending innodb_system data file './ibdata1' is of a different size→ 数据目录损坏，别乱删，先备份/www/server/data再考虑重装 MySQL - 报
Too many connections或Out of memory→ 服务器内存太小（尤其 1G 以下），宝塔默认 MySQL 配置吃不住，需调低innodb_buffer_pool_size
宝塔面板连的是 socket，但 MySQL 绑定了 127.0.0.1
宝塔 PHP 和面板自身连接 MySQL 时，默认走 Unix socket（路径通常是 /tmp/mysql.sock 或 /www/server/data/mysql.sock），而不是 TCP 的 127.0.0.1:3306。如果 MySQL 配置里写了 bind-address = 127.0.0.1 却没配 socket 路径，或者 socket 文件权限不对，面板就找不到它。
- 检查
/etc/my.cnf或/www/server/mysql/etc/my.cnf，确认有类似配置：[mysqld] socket=/www/server/data/mysql.sock
- 确认该 socket 文件真实存在且可读：
ls -l /www/server/data/mysql.sock；若不存在，可能是 MySQL 启动时没写出来，重启前先mkdir -p /www/server/data并确保属主是mysql:mysql - PHP 连接报
SQLSTATE[HY000] [2002] No such file or directory就是 socket 路径对不上，不是密码问题
MySQL 用户权限没给到 localhost
宝塔创建数据库时默认授权用户是 'username'@'localhost'，但有些 MySQL 安装后默认只认 'username'@'127.0.0.1'，或者反过来。如果服务起来了、socket 也通，但面板新建数据库时报“连接失败”，很可能是权限记录不匹配。
- 进 MySQL 命令行（
mysql -uroot -p），运行：SELECT User,Host FROM mysql.user WHERE User='root';
看有没有localhost这一行；没有的话，手动加：CREATE USER 'root'@'localhost' IDENTIFIED BY 'your_root_password'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
- 宝塔的 root 密码不一定等于 MySQL 实际 root 密码——重置过系统密码或改过 MySQL root 密码后，宝塔不会自动同步，得在面板「数据库」页点「修改密码」重新设一遍
- 不要盲目删掉
'root'@'127.0.0.1'，有些 PHP 扩展（如 mysqli）在某些配置下会优先走 TCP，留着更稳妥
宝塔和 MySQL 的连接链路比看起来绕：服务状态、启动日志、socket 路径、权限 Host 匹配，四个环节只要一个断，就显示“无法连接”。最容易忽略的是 socket 文件是否存在且权限正确，而不是急着改密码或重装。
