错误源于phpMyAdmin默认socket路径与MySQL实际路径不匹配，需先执行SHOW VARIABLES LIKE 'socket'确认真实路径，再在config.inc.php中准确配置$cfg['Servers'][$i]['socket']，并确保权限和MySQL配置一致。
phpMyAdmin 默认走 socket，但 MySQL 的 socket 路径不匹配
错误 mysqli_real_connect(): (hy000/2002): no such file or directory 几乎总是因为 phpmyadmin 尝试连接一个并不存在的 .sock 文件。它默认找 /var/run/mysqld/mysqld.sock，但你的 mysql 实际 socket 可能在 /tmp/mysql.sock、/var/lib/mysql/mysql.sock，甚至根本没启用 socket（比如某些 docker 镜像只开 tcp）。
必须先确认真实路径：
- 登录 MySQL 执行：
SHOW VARIABLES LIKE 'socket'; - 或运行：
mysql --help | grep "socket" - 再用
ls -l检查该路径是否存在且可读（例如ls -l /tmp/mysql.sock）
如果路径不存在，说明 MySQL 未启用 socket 连接——常见于配置了 skip-networking 但又没配 socket，或用了非标准安装方式（如 Homebrew on M1/M2、源码编译）。
$cfg['Servers'][$i]['host'] = 'localhost' 会强制走 socket，但 socket 行没配对就失效
phpMyAdmin 中只要 $cfg['Servers'][$i]['host'] 是 'localhost'，PHP 的 MySQLi 就会忽略 port、跳过 TCP，直接尝试 Unix socket 连接。这时如果 $cfg['Servers'][$i]['socket'] 没设、设错、或设了但路径不对，就会报 2002 错误。
正确做法是显式指定 socket 路径：
立即学习“PHP免费学习笔记（深入）”；
- 打开
config.inc.php，找到对应服务器块（通常是$cfg['Servers'][1]） - 添加或修正这一行：
$cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';（路径必须和SHOW VARIABLES输出完全一致） - 确保
$cfg['Servers'][$i]['host'] = 'localhost';（不能是'127.0.0.1'） -
$cfg['Servers'][$i]['port']留空或删掉，避免干扰 socket 逻辑
注意：不写 socket 行 ≠ 自动 fallback 到正确路径；它会硬编码用默认值，而那个默认值在不同系统上差异极大。
socket 文件存在，但 Web 服务用户无权限访问
即使路径对、MySQL 在跑，仍可能报错，现象是命令行 mysql -u root -p 能连，但浏览器里 phpMyAdmin 失败，错误里带 Permission denied。
这是因为 socket 文件的 owner/group 不包含 Web 服务用户（如 www-data、_www 或 apache）：
- 运行
ls -l /path/to/mysql.sock，看输出第三、四列 - 若 owner 不是 Web 用户，需改属组并加读写权限：
sudo chgrp www-data /path/to/mysql.sock && sudo chmod g+rw /path/to/mysql.sock - 更稳妥的做法是让 MySQL 启动时自动设对权限，在
my.cnf的[mysqld]段加：socket_group = www-data和socket_mode = 0660
MySQL 根本没启用 socket，或被 skip-networking 干扰
有些环境（尤其是容器或最小化安装）MySQL 配置了 skip-networking，但它并不会自动启用 socket；相反，它可能同时禁掉 TCP 和 socket，除非你明确配了 socket 路径。
检查配置文件（/etc/mysql/mysql.conf.d/mysqld.cnf 或 /etc/my.cnf）中是否有：
-
skip-networking—— 如果存在，必须搭配有效的socket = /xxx/mysql.sock才能用 socket 连 -
bind-address设为::1或空值 —— 可能导致 MySQL 启动时忽略 socket 初始化 - 没有
[mysqld]段下的socket行 —— 即使没skip-networking，也可能用默认路径，但该路径未必存在
改完配置必须重启 MySQL：sudo systemctl restart mysql，并用 journalctl -u mysql -n 15 --no-pager 确认没报 socket 相关 warning。
最易被忽略的是：socket 路径必须绝对、真实、可访问，且与 phpMyAdmin 配置、MySQL 配置、PHP 自身（mysql.default_socket）三者完全一致——差一个字符或权限位，2002 就照常报。
