localhost在macOS上失效是系统解析机制与MySQL配置共同导致的，需改用127.0.0.1并检查DNS解析、bind-address设置、Navicat连接参数及TLS配置。
localhost 在 macos 上失效，不是 navicat 的 bug，而是系统解析机制和 mysql 配置共同作用的结果。直接换用 127.0.0.1 通常就能连上 —— 但背后原因和潜在坑点比表面更复杂。
Mac 上 localhost 解析失败的常见表现
你看到的典型错误是：2005 - Unknown MySQL server host 'localhost' (0) 或 2002 - Can't connect to server on localhost (10061)。注意：MySQL 服务明明在运行（brew services list 显示 mysql 是 started），Navicat 却报“找不到主机”或“连接被拒绝”。这不是密码错，也不是端口错，是地址解析卡在第一步。
localhost 和 127.0.0.1 在 macOS 上真不一样
macOS 的 /etc/hosts 文件默认包含 127.0.0.1 localhost，但 DNS 解析行为受系统网络配置影响。尤其当你：
- 关闭 Wi-Fi / 无网络连接时，localhost 可能无法反向解析为 127.0.0.1（DNS resolver fallback 失效）
- 使用了某些企业级网络管理工具（如 Cisco AnyConnect、Tunnelblick）后，localhost 被重定向或忽略
- 启用了 macOS 的 dnsdist 或自定义 resolv.conf，导致 loopback 域名解析路径异常
这些情况下，Navicat 调用系统 getaddrinfo() 会返回空或错误，直接失败。
MySQL 的 bind-address 设置会放大这个问题
即使你改用 127.0.0.1，仍可能报 2002 错误。关键要看 MySQL 实际监听在哪：
- 检查 MySQL 是否只绑定了
127.0.0.1：sudo lsof -iTCP:3306 -sTCP:LISTEN，输出中若只有127.0.0.1:3306，说明它不响应localhost的 Unix socket 请求（macOS 默认优先走 socket） - 但 Navicat for Mac 默认走 TCP，不走 socket；所以如果你的
my.cnf里写了bind-address = ::1（IPv6 only），而 Navicat 尝试 IPv4，也会静默失败 - 最稳妥的配置是：
bind-address = 127.0.0.1（明确限定 IPv4 loopback），并确认skip-networking = OFF
Navicat 连接设置里最容易忽略的细节
不只是填个地址那么简单：
- 主机名栏必须填
127.0.0.1，不能留空或填localhost—— 即使你认为它“应该一样” - 端口必须显式填
3306，不要依赖默认值；有些 Homebrew 安装的 MySQL 会用33060（如 MySQL 8.0+ with X Plugin） - “使用 SSH 隧道”选项如果意外勾选，会导致 Navicat 强制走 SSH，而本地没配 SSH 服务，直接超时
- macOS 版 Navicat 16+ 对 TLS 握手更严格，若 MySQL 没开
require_secure_transport = OFF，且 Navicat 连接参数里没关 SSL，也可能静默断连
真正麻烦的不是连不上，而是连不上时你不知道该查哪一层 —— DNS 解析、MySQL 绑定、Navicat 协议栈、macOS 网络栈，四层叠加，任一环节松动都会让 localhost 彻底失效。动手前先跑一句 ping -c 1 localhost && ping -c 1 127.0.0.1，结果不同就别往下试了。
