v3.4.0 稳定版极简极速本地 MySQL 客户端

常见连接故障诊断排查与排障手册 | VloamDb 文档手册

汇总排查 MySQL 连接中最常见的网络、认证插件及 SSH 隧道权限报错与解决方案。

macOS 提示“已损坏”或无法打开

在 macOS Sequoia / Sonoma 等新系统中,由于 Apple Gatekeeper 强化了对非 Mac App Store 软件的沙箱隔离,下载的 DMG 可能会被系统标记隔离属性,提示「VloamDb 已损坏,您应该将它移到废纸篓」。

🛠️
解决方案:清除 xattr 隔离属性

打开终端 (Terminal.app),复制并粘贴执行以下命令:

Terminal
sudo xattr -rd com.apple.quarantine /Applications/VloamDb.app

输入电脑锁屏密码后按回车,再次双击 VloamDb 即可顺利打开。

MySQL 8.0 caching_sha2_password 报错

当连接某些未启用 SSL 的旧版客户端升级至 MySQL 8.0 时,可能会提示 <code>Authentication plugin caching_sha2_password cannot be loaded</code>。

VloamDb 原生内置 <code>caching_sha2_password</code> 与 <code>mysql_native_password</code> 双重鉴权握手协议。如遇到连接异常,请检查:

  • 在连接高级设置中,确认是否开启了「Allow Public Key Retrieval (允许公钥检索)」;
  • 若为云数据库,检查云厂商白名单是否已放行当前客户端出口 IP。

SSH 隧道连接超时与密钥鉴权

通过堡垒机 / 跳板机连接私有内网 MySQL 实例时,若出现 SSH 握手超时:

1. 私钥格式校验

推荐使用 OpenSSH 标准私钥格式 (以 `-----BEGIN OPENSSH PRIVATE KEY-----` 开头)。若使用 PuTTY `.ppk` 文件,请先通过 PuTTYgen 导出为 OpenSSH 格式。

2. 私钥文件权限

在 macOS / Linux 上,私钥权限必须严格限制为 600 (`chmod 600 ~/.ssh/id_rsa`),否则 SSH 协议出于安全考虑会直接拒绝对话。