navicat for mysql 新建连接失败

Navicat for MySQL 的新建连接窗口将数据库地址、端口、账号和认证方式集中在一处。当连接建立失败时，直接修改密码或重装软件往往无济于事。我们需要先建立对界面布局的整体认知，再根据报错表现，依次检查服务器可达性、账号权限以及是否需要 SSH 隧道。以下按连接界面的实际使用关系，说明各区域的检查重点。

Navicat for MySQL 新建连接窗口整体布局，显示 General、SSH 等主要标签页位置

概述

打开 Navicat for MySQL 后，主界面左侧通常显示连接列表。点击“新建连接”并选择 MySQL 类型，会弹出连接属性窗口。这个窗口是排查问题的核心地图，主要包含常规（General）、高级（Advanced）、SSL 和 SSH 等标签页。对于大多数连接失败的情况，问题集中在常规设置的地址端口，或 SSH 隧道的跳板配置上。

关于【连接列表和新建按钮】

在开始排查前，确认操作入口正确。点击工具栏上的“连接”按钮或右键连接列表空白处，选择“新建连接”，务必确保选中的是 MySQL 类型。已有连接配置建议保留原样，新建一个独立名称用于测试，这样可以清晰区分本地数据库、测试环境和正式服务器，避免覆盖可用配置。

连接名称仅是 Navicat 内部的识别标签，与数据库服务器的实际主机名无关。如果之前混淆了 MariaDB 或 SQLite 的配置模板，请重新建立一个标准的 MySQL 连接对象。

关于【General 常规设置】

General 标签页是连接的基础入口，包含连接名、主机（Host）、端口（Port）、用户名（User Name）和密码（Password）。这里是连接失败的高发区，因为任何一项基础信息错误都会导致握手失败。

主机地址应填写数据库服务器提供的 IP 或域名，切勿将其与控制面板登录地址混淆。端口默认为 3306，但云服务器或自定义安装的 MySQL 可能使用其他端口。必须确保此处填写的端口与服务器实际监听的 TCP/IP 端口完全一致，仅修改客户端数字无法改变服务器行为。

General 标签页中的 Host 和 Port 字段细节

关于【Host 主机地址】

Host 字段决定 Navicat 尝试连接哪台机器。连接本机数据库时，localhost 和 127.0.0.1 在某些系统配置下解析结果不同，若遇到奇怪的本机连接问题，可尝试切换这两种写法。连接远程数据库时，必须使用服务商提供的公网 IP 或可解析域名。

如果输入地址后立即提示无法连接，优先检查拼写错误、DNS 解析是否正常，以及服务器防火墙是否允许来自当前电脑 IP 的访问。若服务器配置为仅允许本机连接（bind-address=127.0.0.1），远程 Navicat 必然失败，这并非客户端故障，而是服务器安全策略限制。

关于【Port 端口】

Port 字段用于指定 MySQL 服务的监听端口。虽然 3306 是标准默认值，但不能想当然地认为所有服务器都使用此端口。请在云控制台数据库详情、服务器配置文件或向管理员确认实际端口号。

若出现“Connection refused”或错误码 2003，通常意味着网络层面无法到达目标端口。此时应检查 MySQL 服务是否正在运行、是否绑定了该端口，以及中间防火墙（包括云服务器安全组）是否放行了该端口的入站流量。在服务器未监听端口的情况下，调整密码或字符集设置无效。

关于【User Name 和 Password】

用户名和密码用于数据库层面的身份认证。账号必须在目标 MySQL 实例中存在，且密码严格匹配。如果密码包含特殊字符，建议重新手动输入，注意避免前后多余空格或全角/半角符号混淆。

当报错提示 1044 或 1045（Access denied）时，问题核心在于认证失败。需检查用户名是否正确、密码是否过期、以及该账号是否被授权从当前主机 IP 连接。不要将操作系统登录名或网站后台管理员账号直接等同于 MySQL 数据库账号，除非有明确的映射配置。

SSH 标签页中的跳板机配置参数

关于【SSL 和认证选项】

部分高安全性要求的服务器强制启用 SSL 连接，或使用特定的身份验证插件（如 caching_sha2_password）。相关设置位于 Advanced 或 SSL 标签页。只有当服务器明确要求时，才上传证书文件或勾选 SSL 选项。不确定时随意开启这些功能，可能导致原本简单的网络连接演变为复杂的握手协商失败。

如果本地 Navicat 版本较旧，而服务器使用了新版 MySQL 的默认认证插件，可能出现兼容性问题。此时需确认客户端支持的认证方式，或由管理员在服务器端调整账号的认证插件类型。

关于【SSH Tunnel 隧道设置】

许多托管数据库服务出于安全考虑，不直接开放 MySQL 端口的公网访问，只允许通过 SSH 跳板机连接。Navicat 支持 SSH Tunnel 功能，需在 SSH 标签页填写跳板机的 IP、端口、用户名及认证密钥或密码。

使用 SSH 隧道时，General 页面的 Host 通常填写数据库在内网的地址（如 127.0.0.1 或内网 IP），而 SSH 页面填写公网跳板机地址。务必区分两组账号：SSH 账号用于登录远程服务器操作系统，MySQL 账号用于登录数据库服务。若 SSH 连接本身失败，或服务器禁止端口转发，隧道将无法建立，进而导致数据库连接失败。

点击测试连接后弹出的成功或失败提示框

关于【测试连接按钮】

填写完各项参数后，务必点击窗口底部的“测试连接”按钮。这是最直接的反馈机制。测试时建议一次只修改一个变量，并记录具体的报错文字和错误码，以便精准定位是网络层、传输层还是应用层的问题。

如果测试成功，即可保存连接；如果失败，不要连续快速点击或盲目尝试不同密码。先根据报错判断服务器是否可达，再回溯检查对应字段。若能连接成功但看不到数据库列表，则属于登录后权限或显示刷新问题，与新建连接阶段的网络握手失败性质不同。

关于【常见报错和相邻检查区】

不同的错误提示指向界面中不同的检查区域：

• 无法连接 / Connection refused：重点检查 General 页的 Host、Port，以及服务器防火墙和安全组规则。
• 1130 Host is not allowed：检查 MySQL 用户表中的 Host 字段，服务器可能限制了允许连接的来源 IP。
• 1044 / 1045 Access denied：重点核对 User Name、Password，以及账号的授权范围。
• 连接中途断开：检查网络稳定性、服务器负载，或 SSL 配置是否匹配。

这些错误码提供了排查方向，但最终解决需结合服务器日志和实际网络环境。切勿为了绕过 1130 错误而将用户 Host 设置为任意来源（%），应在确保安全的前提下放宽权限。

关于【保存连接和版本差异】

当参数核对无误且测试连接成功后，再点击确定保存。Navicat 在 Windows、macOS 和 Linux 平台上的界面布局略有差异，但 Host、Port、用户名、密码及 SSH 隧道等核心逻辑保持一致。

如果同一组参数在命令行客户端（如 mysql CLI）中能连接，而在 Navicat 中失败，应对比两者的 SSL、SSH 和认证插件设置。如果命令行也无法连接，则问题出在服务器地址、端口监听、权限或防火墙等基础层面。通过连接列表新建独立配置，在 General 区夯实基础参数，必要时启用 SSH 隧道，最后用测试按钮验证，是解决新建连接失败最高效的路径。

关于【保存连接和版本差异】