最省事的是直接用mysql命令行客户端，linux/macos通常自带，windows需单独安装mysql client；连接失败需逐层排查dns、tcp、认证、权限、ssl及防火墙。
直接用 mysql 命令行客户端最省事
绝大多数 Linux 发行版和 macOS 自带 mysql 命令行工具，只要 MySQL 服务端已安装（或你连的是远程服务器），通常只需确认客户端是否在 $PATH 中。Windows 用户需单独下载 MySQL Community Server 安装包，并勾选 “MySQL Client” 组件——不装完整服务端也能只装客户端。
常见错误现象：command not found: mysql；mysql: command not found；或执行后报错 ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock'（说明客户端存在，但连错了地址或服务未运行）。
- 先检查是否存在：
which mysql或mysql --version - 若不存在，Linux 可用
sudo apt install mysql-client（Debian/Ubuntu）或sudo yum install mysql（CentOS 7）；macOS 推荐brew install mysql-client，然后手动把mysql加入$PATH - Windows 下从 MySQL 官网下载页面 选择 “MySQL Community Server”，运行安装向导时，在 “Features” 步骤展开 “Client Programs”，确保勾选 “MySQL Client”
连接远程 MySQL 时必须注意 host 和权限
本地能连不等于远程能连。默认 MySQL 用户（如 root）通常只允许 localhost 连接，远程 IP 会被拒绝，报错典型为：ERROR 1130 (HY000): Host 'x.x.x.x' is not allowed to connect to this MySQL server。
这不是客户端问题，是服务端权限配置缺失。你需要在服务端执行：
GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'%' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES;
注意：@'%' 表示允许任意主机连接（生产环境应限定具体 IP）；your_user 不能是 root 且已存在；如果用户不存在，需先 CREATE USER。
- 连接命令格式：
mysql -h 192.168.1.100 -P 3306 -u your_user -p（-h后跟 IP 或域名，-P是大写 P，指定端口） - 若服务端防火墙开启（如
ufw或firewalld），需放行 3306 端口 - 云服务器（如阿里云、腾讯云）还需检查安全组规则是否开放 3306 入方向
DBeaver / TablePlus / Navicat 这类 GUI 工具本质还是调用 JDBC 或 libmysql
它们不是独立协议实现，底层仍依赖 MySQL 的通信协议，所以遇到连接失败时，优先用命令行 mysql -h ... -u ... -p 验证通路。GUI 工具的报错信息往往更模糊（比如只写 “Connection refused”），而命令行会明确提示是 DNS 解析失败、端口不通、认证失败还是权限拒绝。
- DBeaver 默认使用 JDBC 驱动，首次连接需下载对应版本的
mysql-connector-java（新版推荐 8.0+）；若连 MySQL 8.0+，JDBC URL 要加?serverTimezone=UTC，否则可能报时区错误 - TablePlus 对 MySQL 8.0+ 的 caching_sha2_password 插件支持较好，但旧版 Navicat（v12 以前）可能需要服务端降级认证插件：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 所有 GUI 工具的 SSL 设置项（如 “Use SSL”、“Verify server certificate”）若勾选了但服务端没配证书，会导致连接卡住或直接失败
SSL 连接不是可选项，而是生产环境强制要求
明文传输账号密码极其危险。MySQL 5.7+ 默认启用 require_secure_transport = ON 时，任何非 SSL 连接都会被拒绝，报错：ERROR 3159 (HY000): Connections using insecure transport are prohibited while --require-secure-transport=ON.
此时命令行必须加 --ssl-mode=REQUIRED 参数，例如：
mysql -h db.example.com -u app_user -p --ssl-mode=REQUIRED
如果你控制不了服务端配置，又必须走加密通道，可用 SSH 隧道中转：
ssh -L 3307:127.0.0.1:3306 user@db-server-ip
然后本地连 127.0.0.1:3307，实际流量经 SSH 加密转发。
- 服务端要启用 SSL，需配置
ssl-ca、ssl-cert、ssl-key三项参数并重启 mysqld - 客户端验证证书时，需额外指定
--ssl-ca=/path/to/ca.pem；若跳过验证（仅加密不验签），可用--ssl-mode=VERIFY_IDENTITY或更低等级 - 很多云数据库（如 AWS RDS、阿里云 RDS）提供下载根证书的链接，务必导入并显式指定，否则 GUI 工具可能静默失败
MySQL 客户端环境真正难的从来不是“装什么”，而是搞清每层拦截点：DNS 解析 → TCP 连通性 → 认证插件兼容性 → 账号 host 权限 → SSL 策略 → 防火墙/安全组。少漏一环，就卡在某个看似无关的报错里。
