MySQL Workbench及HeidiSQL无法连接远程MySQL数据库报错排查

所有排查操作均在本地设备完成，无需服务端管理权限。

一、修复MySQL Workbench配置错误（对应"Unable to connect to localhost"报错） #

该报错触发原因是Workbench默认配置强制优先使用本地套接字连接，覆盖了你填写的远程TCP/IP参数，按以下步骤调整：

• 打开MySQL Workbench，在首页连接列表右键目标连接，选择「Edit Connection」
• 确认Connection Method选中Standard (TCP/IP)，不要选择带Local Socket/Pipe、SSH Tunnel的选项
• 核对Hostname字段值为169.62.56.10，字段前后无多余空格、未误填为localhost/127.0.0.1，Port字段值为3306
• 切换到「Advanced」标签页，清空「Socket/Pipe path」输入框内的所有默认填充内容
• 仅保留「Use compression protocol」勾选，取消其余所有本地关联选项的勾选，点击「Test Connection」验证

二、排查网络连通性问题（对应HeidiSQL 10060连接超时报错） #

10060错误本质是本地到目标服务器3306端口的TCP连接未建立，按以下顺序排查：

• 验证端口连通性
  1. 打开「控制面板-程序和功能-启用或关闭Windows功能」，勾选「Telnet Client」完成安装
  2. 打开命令提示符，执行命令 telnet 169.62.56.10 3306
  3. 如果执行后窗口变为纯黑无报错，说明端口连通正常；如果提示连接失败，说明3306端口被本地网络拦截：
     • 若当前使用公司、校园、公共WiFi网络，这类网络默认会封禁3306等数据库服务端口，直接切换到手机流量热点给笔记本连接后重试即可
     • 检查本地安装的360安全卫士、腾讯电脑管家、火绒等安全软件的网络防护规则，删除3306端口的出站拦截规则，或临时完全退出安全软件后重试
• 修复代理/VPN导致的路由异常
  本地开启的VPN、系统代理、网络加速器会改写路由表，导致连接被转发到错误节点：
  1. 完全退出所有VPN、代理、加速类软件，打开Windows「设置-网络和Internet-代理」，关闭所有代理开关
  2. 打开命令提示符依次执行以下命令重置本地网络栈：

     ipconfig /flushdns
     netsh winsock reset
     netsh int ip reset
     

  3. 重启电脑后重新测试连接
• 修复HeidiSQL驱动兼容问题
  MySQL 8.0默认使用caching_sha2_password认证协议，旧版libmysql驱动不支持该协议：
  1. 打开HeidiSQL连接配置页，Network type保持「MariaDB or MySQL (TCP/IP)」
  2. 点击Library旁的选择按钮，选中HeidiSQL安装目录自带的libmariadb.dll，不要使用第三方来源的旧版libmysql.dll
  3. 勾选「Use compression」选项后重试连接

三、补充说明 #

• 本地无需安装MySQL服务，仅安装客户端工具即可连接远程数据库，该认知正确
• 所有连接参数填写时注意不要带入前后空格，尤其是密码字段，复制粘贴时极易带入多余空格导致认证失败
• 如果切换手机热点后连接正常，说明原使用的宽带/局域网存在3306端口出站封禁，后续可通过SSH隧道方式绕过封禁连接，无需服务端额外调整配置

内容的提问来源于stack exchange，提问作者Pigasus Studio