phpMyAdmin不支持单服务器配置中混用socket与TCP，必须二选一：设socket则忽略host/port；设host需用127.0.0.1而非localhost并清空socket字段，否则mysqli优先走socket导致连错实例。
phpMyAdmin 不支持单个服务器配置里混用 socket 和 TCP
你不能在一个 $cfg['Servers'][$i] 里既填 socket 又填 host 或 port。MySQL 客户端库（mysqli）在连接时只走一条路径：要么 Unix socket 文件，要么 TCP/IP 地址+端口。phpMyAdmin 会按以下优先级决定走哪条路：socket 字段存在且非空 → 强制走 socket；否则才 fallback 到 host+port。一旦你两个都写了，mysqli 实际只认 socket，host 被忽略——但你可能误以为它在连远程，结果连的是另一个本地实例的 socket 文件。
- Socket 连接必须指向真实存在的文件路径，比如
/var/run/mysqld/mysqld.sock，且该文件所属 MySQL 实例必须正在运行 - TCP 连接要求
host是可路由地址（如127.0.0.1、容器名mysql57），不能写localhost——因为 PHP 的 mysqli 扩展对localhost有特殊处理：默认强制走 socket，哪怕你同时写了port - 多实例共存时，每个实例的 socket 路径必须不同（例如 MySQL 5.7 用
/var/lib/mysql57/mysql.sock，8.0 用/var/lib/mysql80/mysql.sock），否则 phpMyAdmin 会连错服务
本地多实例必须区分 socket 路径或显式禁用 socket
如果你有多个 MySQL 实例跑在同一台机器上（比如 Docker 多容器或源码多端口部署），它们的 socket 文件不能同名同路径。常见错误是所有实例都默认写进 /var/lib/mysql/mysql.sock，结果后启动的覆盖前一个，phpMyAdmin 总是连到“最后那个”。
- 查每个实例实际监听的 socket：进对应 MySQL 容器或进程，执行
mysql -uroot -e "SHOW VARIABLES LIKE 'socket';" - 在
$cfg['Servers'][$i]中只保留一种连接方式：要走 socket 就只设socket，要走 TCP 就把host设成127.0.0.1（不是localhost），并确保socket字段完全不出现（留空或 unset） - 若某实例只监听 socket（如某些安全加固配置），而你又想用 TCP 连，只能改它的
my.cnf，加bind-address = 127.0.0.1并重启，否则 TCP 端口根本不会开
认证插件不兼容会让 socket/TCP 表现一致地失败
MySQL 8.0 默认用 caching_sha2_password，而 phpMyAdmin 4.9 的 mysqli 扩展压根不支持它。无论你走 socket 还是 TCP，只要目标用户 plugin 是这个，登录页就会静默卡住或跳回空表单，错误日志里也不会提认证问题——只会报泛泛的 #2002 Cannot log in to the MySQL server。
- 检查用户认证方式：
SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user'; - 临时修复（开发环境）：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx'; FLUSH PRIVILEGES; - 生产环境建议：升级 phpMyAdmin 到 5.0+，或改用支持新插件的 PDO 扩展（需手动改 phpMyAdmin 源码，不推荐）
配置索引断档会导致部分实例“消失”
phpMyAdmin 加载 $cfg['Servers'] 时，遇到第一个空值、语法错误或跳号（比如只有 [1] 和 [3]），就立刻中止后续所有条目。你以为配了三台，实际只加载了第一台，第二台因索引缺 [2] 被跳过，第三台更没机会读到。
- 绝对不要手写
$cfg['Servers'][1]、$cfg['Servers'][2]……容易漏分号、引号不闭合、索引写错 - 必须用循环生成，索引从
1开始严格递增：foreach ($hosts as $i => $h) { $cfg['Servers'][$i] = [...]; } - 每个
$cfg['Servers'][$i]必须含host或socket+auth_type，缺一不可；auth_type推荐统一用'cookie'，避免'config'模式下密码为空导致跳过
socket 路径是否真实存在、localhost 是否被 mysqli 悄悄转成 socket、索引是否连续、认证插件是否被支持——这四点任何一个出问题，都会让“看起来应该能连”的配置彻底失效。别依赖报错信息，先用 mysql -S /path/to/socket -u... 或 mysql -h 127.0.0.1 -P 3307 -u... 手动验证每台实例的底层连通性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
