MySQL在IPv6环境下localhost解析为::1但未监听或授权该地址，导致phpMyAdmin静默连接失败；应检查ss -tln输出、配置bind-address = ::、创建'root'@'::1'用户并设mysql_native_password认证插件，或改phpMyAdmin配置为127.0.0.1避坑。
phpMyAdmin 连接 localhost 失败，但 IPv6 已启用
不是配置写错了，是 mysql 默认不响应 localhost 在 ipv6 环境下的解析行为。系统把 localhost 解析成 ::1（ipv6 回环地址），而 mysql 若未显式监听 ::1 或未授权该 host，连接就会静默失败，甚至不报错。
常见现象：页面卡在登录页、无错误提示、或报 HY000/2002；mysql -h localhost -u root -p 也连不上，但 mysql -h 127.0.0.1 -u root -p 正常。
- 检查 MySQL 是否监听 IPv6：
ss -tln | grep :3306，若只看到127.0.0.1:3306而没有::1:3306，说明没开 IPv6 监听 - 确认配置文件（如
/etc/mysql/mysql.conf.d/mysqld.cnf）中存在且未注释：bind-address = ::或bind-address = *（后者兼容 IPv4/IPv6） - 重启 MySQL 后，再执行：
SELECT Host,User FROM mysql.user WHERE User='root';，看是否有::1对应的记录；没有就补一条：CREATE USER 'root'@'::1' IDENTIFIED BY 'your_pass'; GRANT ALL ON *.* TO 'root'@'::1' WITH GRANT OPTION; - 别忘了
FLUSH PRIVILEGES;
phpMyAdmin 配置里用 localhost 还是 127.0.0.1？
在 IPv6 环境下，localhost 和 127.0.0.1 行为完全不同——前者触发 DNS 解析，可能落到 ::1；后者强制走 IPv4 TCP。如果你不想改 MySQL 的 IPv6 配置，最稳的做法是绕过解析歧义。
- 把
$cfg['Servers'][$i]['host']显式设为127.0.0.1，而非localhost - 同时确保
$cfg['Servers'][$i]['port']是实际监听端口（默认3306） - 不要设
socket参数，否则会覆盖网络连接逻辑 - 如果必须用
localhost（比如依赖 Unix socket 的本地部署），请确认mysqld的skip-networking是OFF，且socket路径正确（如/var/run/mysqld/mysqld.sock）
MySQL 8.0+ 用户权限绑定 IPv6 地址后 phpMyAdmin 登录失败
MySQL 8.0 默认启用 caching_sha2_password 插件，而旧版 phpMyAdmin（尤其搭配 PHP 7.x）不支持该认证方式；更隐蔽的是：即使你用了新认证，'root'@'::1' 和 'root'@'localhost' 是两个完全独立的用户账号，密码、插件、权限互不影响。
- 先查目标用户的认证插件：
SELECT plugin FROM mysql.user WHERE User='root' AND Host='::1'; - 若返回
caching_sha2_password，且 phpMyAdmin 报The server requested authentication method unknown to the client，执行：ALTER USER 'root'@'::1' IDENTIFIED WITH mysql_native_password BY 'your_pass'; - 如果用 Docker 启动 MySQL，确保加了
--default-authentication-plugin=mysql_native_password参数 - 注意：修改后必须
FLUSH PRIVILEGES;，且 phpMyAdmin 缓存可能残留旧 session，建议清浏览器 cookie 或换隐身窗口重试
防火墙和 SELinux 拦截了 ::1 的本地回环流量
某些发行版（如 CentOS/RHEL）的 firewalld 或 SELinux 策略，默认不放行 ::1 上的 loopback 流量，哪怕服务监听正常、权限也对，连接仍会超时或拒绝。
立即学习“PHP免费学习笔记（深入）”；
- 临时关闭测试：
sudo systemctl stop firewalld（firewalld）或sudo setenforce 0（SELinux） - 若关闭后恢复，说明策略限制：firewalld 需加规则
sudo firewall-cmd --add-service=mysql --permanent；SELinux 可尝试sudo setsebool -P httpd_can_network_connect_db 1 - 宝塔面板用户注意：其内置防火墙可能单独拦截
ip6tables规则，需在【安全】→【防火墙】中手动放行 IPv6 的 3306 端口
实际调试时，最容易被忽略的是：MySQL 用户表里 Host 字段必须精确匹配连接来源的 IP 解析结果——localhost ≠ 127.0.0.1 ≠ ::1，三者互不继承权限，缺一不可。
