必须验证登录页是否显示所有服务器下拉选项，若仅显示一个则说明索引未从1开始连续递增；点击“go”后需确认是否真实连接而非页面跳转，host必须为可直连地址、port为映射端口且无单位；登录后应执行select @@hostname, @@port验证实际连接目标。
配置完 config.inc.php 中的多个服务器条目后，不能直接刷新页面就认为“连上了”——90% 的连接失败发生在配置保存后未验证关键环节，而非配置本身写错。
登录页是否显示所有服务器下拉选项
这是最基础的“配置已加载”信号。如果只看到一个服务器（比如只有 localhost），说明 $i 索引没对齐或配置被跳过：
-
$i必须从1开始递增，且不能复用或重置；常见错误是保留了原始的$i = 0行又在后面手动$i++，导致第一个服务器写到$cfg['Servers'][1]，第二个却写到$cfg['Servers'][2]，但中间漏掉索引 1 的完整定义 - 检查是否有条件语句包裹服务器配置（如
if ($env === 'dev')），phpMyAdmin 启动时不进入该分支，整段配置不生效 - 确认没有重复定义同一索引，例如两次都写了
$cfg['Servers'][2]['host']，后者会覆盖前者
点击服务器后是否触发真实连接（而非仅页面跳转）
下拉选择某台服务器并点“Go”，若页面卡住、白屏或报 #2002 Cannot log in to the MySQL server，问题大概率出在穿透层或网络层：
- 填进
$cfg['Servers'][$i]['host']的必须是穿透服务分配的**可直连地址**，比如mydb.cpolar.io或123.45.67.89，绝不能是localhost或内网 IP（如192.168.1.100） -
$cfg['Servers'][$i]['port']必须是穿透映射后的端口（如12345），且不能带单位或斜杠（'12345/tcp'会导致 PHP 解析为 0） - 若穿透链路不稳定，加一行
$cfg['Servers'][$i]['connect_timeout'] = 30;，避免默认 5 秒超时误判为宕机
登录成功后能否执行 SQL 或查看数据库列表
能进登录页、选服务器、输密码进主页，不代表真正连到了目标实例——可能连的是默认 localhost:3306（因配置字段残留）：
- 检查左侧数据库列表是否包含该服务器上真实存在的库名，而不是只有
information_schema或空列表 - 执行一条简单查询如
SELECT @@hostname, @@port;，返回值应与你配置的host和port语义一致（比如 hostname 是远程主机名，不是本地机器名） - 重点排查
$cfg['Servers'][$i]['socket']：如果之前配过本地 socket，这行没删/注释，phpMyAdmin 会优先走 socket 而忽略host+port，导致“看似连上，实则连错”
最容易被忽略的是：改完 config.inc.php 后没清浏览器缓存或没重启 PHP 进程（尤其用 PHP-FPM 时），导致旧配置仍在运行。验证前先 curl -I http://your-phpmyadmin-url/ 看响应头是否含新 PHP 版本或时间戳变化，比盲目重试更省时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
