MySQL 8.0初次安装后无法远程连接是因四层默认封锁：bind-address=127.0.0.1、仅存'root'@'localhost'、默认caching_sha2_password插件、防火墙/安全组拦截3306端口，须同步修改监听地址、创建指定mysql_native_password插件的远程用户、授权并刷新、放行端口。
MySQL 8.0 初次安装后无法远程连接，不是配置“没开好”，而是四层默认封锁同时生效：监听地址锁死在 127.0.0.1、root 用户只存在于 'root'@'localhost'、认证插件强制为 caching_sha2_password、系统防火墙/云安全组默认拦截 3306 端口。任一环节未解，连接必败。
bind-address = 127.0.0.1 导致请求根本进不来
MySQL 进程启动后默认只监听本地回环地址，外部 TCP 请求连握手阶段都触发不了，直接报 ERROR 2003 (HY000): Can't connect to MySQL server。
- 配置文件位置：
/etc/mysql/mysql.conf.d/mysqld.cnf（Ubuntu/Debian）或/etc/my.cnf（CentOS/RHEL），Windows 是C:\ProgramData\MySQL\MySQL Server 8.0\my.ini - 必须在
[mysqld]段下将bind-address = 127.0.0.1改为bind-address = 0.0.0.0或直接注释掉整行 - 改完必须重启服务：
sudo systemctl restart mysql（Linux）或net stop mysql80 && net start mysql80（Windows） - 验证是否生效：
sudo ss -tlnp | grep :3306，输出中Local Address必须是*:3306或0.0.0.0:3306，不能只有127.0.0.1:3306
'root'@'localhost' 和 'root'@'%' 是两条完全独立的记录
执行 GRANT ALL ON *.* TO 'root'@'localhost' 对远程连接毫无作用——MySQL 认证时严格匹配 User + Host 组合，'root'@'localhost' 只接受 Unix socket 或 127.0.0.1 的连接，对任何公网/内网 IP 都直接拒绝。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 不要用
UPDATE mysql.user SET host = '%'：MySQL 8.0 会报ERROR 1396 (HY000)，且破坏系统表结构 - 正确做法是显式创建新用户：
CREATE USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'YourStrongPass!2026'; - 如果报
ERROR 1396，说明该用户已存在但插件不匹配，改用：ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'YourStrongPass!2026'; - 授权后必须执行：
FLUSH PRIVILEGES;，否则权限仍在内存缓存中未加载
caching_sha2_password 插件导致客户端握手失败
MySQL 8.0 默认使用 caching_sha2_password 认证插件，但 Navicat、旧版 JDBC、PyMySQL、PHP mysqli 等大量客户端不支持，会卡在连接阶段，报错如 ERROR 2059 (HY000): Authentication plugin 'caching_sha2_password' cannot be loaded 或静默超时。
- 不能靠客户端“兼容模式”解决，必须服务端指定插件
-
CREATE USER或ALTER USER时必须显式写IDENTIFIED WITH mysql_native_password - 验证是否生效：
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';，返回的plugin字段必须是mysql_native_password - 生产环境强烈建议新建专用用户（如
'app_user'@'192.168.10.%'），而非开放'root'@'%'
防火墙和云安全组是最后一道隐形墙
即使数据库配置全对，ERROR 2003 仍可能持续出现——因为请求在到达 MySQL 前就被操作系统或云平台丢弃了，日志里甚至不会留下痕迹。
- Linux（ufw）：
sudo ufw allow 3306/tcp（注意不是ufw allow 3306，后者默认开 UDP） - Linux（firewalld）：
sudo firewall-cmd --permanent --add-port=3306/tcp && sudo firewall-cmd --reload - Windows 防火墙：新建「入站规则」→「端口」→「TCP 3306」→ 勾选「域、专用、公用」网络
- 阿里云/腾讯云等：必须手动在「安全组」中添加入方向规则，放行
3306端口，仅改服务器防火墙无效
最容易被忽略的是 Docker 冲突：若服务器上曾运行过 MySQL 容器，其数据卷（默认 /var/lib/mysql）可能与本地安装的 MySQL 共享路径，导致配置读取混乱。排查时先确认 ps aux | grep mysql 是否有多个 mysqld 进程，再检查 docker ps 是否残留容器。
