最常见的原因是host设为192.168.1.100或localhost.localdomain而MariaDB仅监听127.0.0.1,或port未同步修改为实际监听端口(如3307),必须用'localhost'/'127.0.0.1'、确保port一致、auth_type为'cookie'或'config'且密码非空。

phpMyAdmin config.inc.php 中 host 和 port 配置错误
最常见的原因是 config.inc.php 里写错了数据库地址或端口。比如把 $cfg['Servers'][$i]['host'] 设成 192.168.1.100 或 localhost.localdomain,而 MariaDB 只监听 127.0.0.1;或者改过 MariaDB 端口(如 3307),但配置里仍是默认的 3306。
必须确保:
-
$cfg['Servers'][$i]['host']是'localhost'或'127.0.0.1'(不要用域名、0.0.0.0或公网 IP) -
$cfg['Servers'][$i]['port']与mysqld实际监听端口完全一致(查netstat -tuln | grep :330确认) -
$cfg['Servers'][$i]['auth_type']为'cookie'或'config',且对应字段未留空(尤其是password)
MariaDB 服务未运行或启动失败
CentOS 7+ 默认用 systemctl 管理服务,service mariadb start 很可能无效。若 systemctl status mariadb 显示 inactive (dead) 或报错,说明服务根本没起来。
排查要点:
立即学习“PHP免费学习笔记(深入)”;
- 执行
sudo systemctl start mariadb后,立刻运行sudo systemctl status mariadb查看真实状态和错误日志 - 常见失败原因:端口被占(
sudo lsof -i :3306)、数据目录权限不对(sudo chown -R mysql:mysql /var/lib/mysql)、/etc/my.cnf语法错误(注释掉新增配置逐行测试) - 确认安装完整:
rpm -qa | grep mariadb应至少包含mariadb-server和mariadb两个核心包
root 用户 Host 权限不匹配
即使 MariaDB 在跑、phpMyAdmin 配置也对,仍可能报 “Host ‘localhost’ is not allowed to connect”。这是因为 MySQL/MariaDB 的用户权限是按 User@Host 组合校验的,而新装 MariaDB 的 root 用户默认只允许从 127.0.0.1 连,不认 localhost(二者在 Unix socket 下行为不同)。
验证和修复方法:
- 先用命令行登录:
mysql -u root -p,成功后执行SELECT User, Host FROM mysql.user WHERE User='root'; - 如果结果中没有
localhost行,就手动加:CREATE USER 'root'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION; - 别忘了
FLUSH PRIVILEGES;,否则不生效
SELinux 或 Apache 权限阻止本地 socket 访问
CentOS 默认开启 SELinux,它会拦截 Apache 子进程通过 Unix socket(如 /var/lib/mysql/mysql.sock)连接 MariaDB,即使网络端口通也没用。现象是 phpMyAdmin 页面空白或报 “Connection refused”,但 mysql -u root -p 命令行能连。
快速验证和临时解决:
- 执行
sudo setsebool -P httpd_can_network_connect_db 1开放 Apache 访问数据库的 SELinux 策略 - 或检查 socket 文件权限:
ls -l /var/lib/mysql/mysql.sock,确保属组是mysql,且 Apache 进程(通常是apache或www-data)有读写权 - 不建议直接关 SELinux(
setenforce 0),仅用于测试定位
真正卡住的地方往往不是某一个配置项,而是多个环节叠加:比如 MariaDB 启动了但 root 用户没开 localhost 权限,同时 SELinux 又拦住了 socket 连接——这时只改 config.inc.php 没用,得一层层剥开看日志和实际连接路径。



















