如何解决phpMyAdmin连接IPv6 MySQL服务器失败-phpMyAdmin-PHP中文网

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' 是两个完全独立的用户账号，密码、插件、权限互不影响。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先查目标用户的认证插件：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 流量，哪怕服务监听正常、权限也对，连接仍会超时或拒绝。

临时关闭测试：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，三者互不继承权限，缺一不可。