应直接查看 error_log 和调用 mysqli_connect_error() 定位 phpmyadmin 数据库连接失败原因：前者记录 php 底层错误（如路径、权限问题），后者返回精准错误码（如2002/2003/1045）及信息，远超页面模糊提示。
直接看 error_log 和 mysqli_connect_error()
phpMyAdmin 本身不提供自定义错误处理器来接管数据库连接失败的细节，它依赖 PHP 原生的 mysqli 或 PDO 报错机制。真要定位连接失败原因，得绕过界面，直奔底层报错源头。
典型现象是页面卡在“无法连接到 MySQL 服务器”或空白，但没具体错误。这时你不能只刷新页面，而应立刻查两处：
-
error_log（PHP 错误日志）：宝塔默认路径是/www/wwwlogs/php_errors.log；若没开启，检查php.ini中log_errors = On和error_log = /path/to/your/log - 手动触发
mysqli_connect_error()：进到 phpMyAdmin 安装目录（如/www/server/phpmyadmin/phpmyadmin_XXXXXX/），临时新建一个test_db.php，内容为：
<?php $host = '127.0.0.1';
$port = 3306;
$user = 'root';
$pass = 'your_password';
$conn = mysqli_connect($host, $user, $pass, '', $port);
if (!$conn) {
echo 'mysqli_connect_error(): ' . mysqli_connect_error();
echo '<br>errno: ' . mysqli_connect_errno();
}
?>
访问该文件，就能看到真实错误码和信息，比如 mysqli_connect_error() 返回 Connection refused（端口未监听）、No such file or directory（socket 路径错）、Access denied（用户权限或密码错）等。
config.inc.php 里加 $cfg['Servers'][$i]['verbose'] 和错误日志开关
phpMyAdmin 的 config.inc.php 支持显式启用调试输出，但仅限于连接成功后的操作层，对连接建立失败本身无效。不过它能帮你确认配置是否被正确加载，以及是否触发了预期的认证流程。
在 $cfg['Servers'][$i] 数组里添加这两项：
-
$cfg['Servers'][$i]['verbose'] = 'Local MySQL';—— 让登录页显示这个别名，避免配错$i索引导致整个 server 配置被跳过 -
$cfg['Verbose'] = true;（全局）—— 启用更详细的界面提示，比如在登录失败时多显示一句“请检查用户名和密码是否匹配 MySQL 中的记录” - 确保
$cfg['ShowChgPassword'] = true;，否则即使密码错，也不会提示重设入口
注意：$cfg['Servers'][$i]['auth_type'] 必须是 cookie 或 http 才会走验证流程；如果设成 config，phpMyAdmin 会直接用配置里写的账号连，连不上就静默失败，毫无提示。
为什么 mysqli_real_connect() 报错比页面提示更有价值
phpMyAdmin 底层调用的是 mysqli_real_connect()，它的错误码比前端文字提示精准得多。例如：
- 错误码
2002：对应No such file or directory→ 实际是 socket 文件路径不对，常见于 MySQL 配置了socket=/tmp/mysql.sock，但 phpMyAdmin 默认找/var/lib/mysql/mysql.sock - 错误码
2003：对应Can't connect to MySQL server on 'xxx'→ 网络层不通，可能是防火墙拦了 3306，或bind-address设成了127.0.0.1却用localhost连（触发 socket 模式失败） - 错误码
1045：对应Access denied for user→ 用户存在但 Host 不匹配，比如 MySQL 里root@127.0.0.1存在，但配置里写的是localhost（MySQL 会优先尝试 socket，而localhost不走 TCP）
这些细节全藏在 mysqli_connect_errno() 和 mysqli_connect_error() 里，不手动调一次，光看 phpMyAdmin 页面根本看不到。
别信 config.inc.php 里的注释示例
很多教程抄来抄去，把 config.inc.php 里的默认注释当真。比如这行：
// $cfg['Servers'][$i]['host'] = 'localhost';
看着没问题，但实际运行时，localhost 在 Linux 下会强制走 Unix socket，而 127.0.0.1 才走 TCP。如果你的 MySQL skip-networking 关了、bind-address 是 127.0.0.1，那用 localhost 就会因找不到 socket 文件而报 2002。
真正稳妥的写法是：
- 统一用
$cfg['Servers'][$i]['host'] = '127.0.0.1';（强制 TCP） - 显式指定端口：
$cfg['Servers'][$i]['port'] = '3306';（哪怕没改过，也写上） - 删掉所有关于
socket的配置项，除非你明确知道 MySQL 的 socket 路径且已同步填入$cfg['Servers'][$i]['socket']
复杂点在于：MySQL 的 host 权限校验、PHP 的 socket/TCP 路由逻辑、Linux 的 /etc/hosts 解析，三者混在一起，一个字母写错，错误就藏得极深。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
