Navicat无法连接MySQL容器的三大核心原因是端口未正确映射、MySQL未授权远程访问、Navicat主机地址填写错误；需依次验证docker ps端口映射、ALTER USER修改认证插件并授权root@'%'、根据环境填localhost/host.docker.internal/公网IP。
确认容器端口是否已正确映射到宿主机
navicat 无法连接最常见原因：mysql 容器没把 3306 端口暴露给宿主机。运行容器时必须用 -p 参数显式映射，比如 -p 3306:3306 或 -p 3307:3306。只写 -p 3306（不带宿主机端口）是无效的，docker 会随机分配宿主机端口，你根本不知道连哪个。
验证方式：执行 docker ps，检查 PORTS 列是否显示类似 0.0.0.0:3306->3306/tcp。如果没有，说明映射失败，需删掉容器重新运行。
- 若宿主机 3306 已被占用，改用其他端口（如
-p 3307:3306），Navicat 主机填localhost，端口填3307 - Windows WSL 用户注意：
localhost指的是 WSL2 虚拟机内部地址，不是 Windows 本机；此时应填host.docker.internal或宿主机真实 IP - Docker Desktop for Mac/Windows 默认支持
host.docker.internal，但 Linux Docker 不支持，需手动加--add-host=host.docker.internal:host-gateway
检查 MySQL 是否允许远程连接
默认 MySQL 8+ 使用 caching_sha2_password 插件，而 Navicat 16 旧版本（尤其未更新到 v16.3+）可能不兼容，直连会报 Authentication plugin 'caching_sha2_password' cannot be loaded。
进容器执行 mysql -uroot -p 后运行：
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
如果 plugin 是 caching_sha2_password，执行：
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码';<br>FLUSH PRIVILEGES;
- 必须确保用户 host 是
%或具体 IP（如172.17.0.1），不能是localhost—— 容器内localhost只响应 Unix socket，Navicat TCP 连接走不通 - MySQL 5.7 默认允许
root@'%'，但 MySQL 8.0+ 初始化后默认只有root@localhost，必须手动授权 - 修改完记得重启容器或执行
mysqladmin -uroot -p reload
Navicat 连接配置中“主机”填什么？
取决于你的部署环境，不是统一填 localhost：
- 容器与 Navicat 在同一台物理机（Linux/macOS 原生 Docker）：
localhost或127.0.0.1（前提是端口已映射） - Windows/macOS 上用 Docker Desktop：
host.docker.internal更可靠（避免 DNS 解析问题） - 远程服务器（如云主机）上跑 Docker：
服务器公网IP，且需确认安全组/防火墙放行对应端口（如 3306） - 用 SSH 隧道连接（推荐用于生产）：Navicat 选 “SSH” 标签页，填服务器 IP 和账号密码，再在 “常规” 页填
127.0.0.1作主机、3306作端口 —— 此时流量经 SSH 加密转发，不直接暴露数据库端口
填错主机最典型表现：Navicat 报 Connection refused 或超时，而非认证失败。
字符集与连接参数建议
Navicat 连接成功但中文乱码？大概率是字符集没对齐。在 Navicat 新建连接的 “高级” 页里，勾选 Use Unicode UTF-8 for filenames，并在 “SSL” 页下方 “Initial SQL” 输入框里加一行：
SET NAMES utf8mb4;
同时确保容器启动时指定了字符集参数（否则 MySQL 8.0+ 默认 utf8mb4，但部分镜像可能未生效）：
docker run ... -e MYSQL_COLLATION=utf8mb4_unicode_ci --character-set-server=utf8mb4 ...
- 别信“自动检测”，Navicat 的 “字符集” 下拉菜单选
UTF-8即可，不用刻意匹配 MySQL 服务端值 - 如果连接后建库建表仍乱码，检查容器挂载的
my.cnf是否含[mysqld]段落并明确写了character-set-server = utf8mb4 - Navicat 16.3+ 对 MySQL 8.0 支持更好，老版本（如 16.0.x）遇到握手失败，优先升级客户端
