问题：mysqlsh.exe连接数据库失败如何排查？

Question

**问题描述：** 使用 `mysqlsh.exe` 连接 MySQL 数据库时出现连接失败，常见错误包括无法连接到主机、认证失败、端口不通、SSL 连接问题等。排查时应检查网络连通性、MySQL 服务状态、用户权限配置、SSL 设置及防火墙规则，同时可尝试通过日志分析具体错误信息。此外，确保使用正确的连接协议（如 X Protocol 或 Classic Protocol）及 mysqlsh 的连接语法格式是否正确。

Answer 1

1. 问题背景与常见错误分类

使用 mysqlsh.exe 连接 MySQL 数据库时，常见的连接失败问题主要包括以下几类：

• 无法连接到主机：可能由于网络不通、主机名解析失败或IP地址错误。
• 认证失败：用户名或密码错误，或用户没有从当前主机连接的权限。
• 端口不通：MySQL 服务未监听默认端口（如 3306 或 X Protocol 的 33060），或端口被防火墙阻挡。
• SSL 连接问题：SSL 配置不匹配，如未启用 SSL、证书不匹配等。
• 协议配置错误：未正确使用 Classic Protocol 或 X Protocol。

2. 基础排查流程

以下是一个基础的排查流程图，帮助快速定位连接失败的原因：

graph TD
            A[开始连接] --> B{网络是否通?}
            B -- 是 --> C{MySQL服务是否运行?}
            C -- 是 --> D{端口是否开放?}
            D -- 是 --> E{用户权限是否正确?}
            E -- 是 --> F{SSL配置是否匹配?}
            F -- 是 --> G[连接成功]
            B -- 否 --> H[检查网络配置]
            C -- 否 --> I[启动MySQL服务]
            D -- 否 --> J[检查防火墙设置]
            E -- 否 --> K[调整用户权限]
            F -- 否 --> L[调整SSL配置]

3. 深入排查与解决方案

3.1 网络连通性检查

使用 ping 或 telnet 检查目标主机是否可达：

ping 192.168.1.100
telnet 192.168.1.100 3306

若 telnet 无法连接，则可能是防火墙或服务未监听该端口。

3.2 MySQL 服务状态检查

登录目标服务器，使用如下命令检查服务状态：

systemctl status mysql
netstat -tulnp | grep mysql

3.3 用户权限配置

在 MySQL 中执行以下 SQL 查看用户权限：

SELECT User, Host FROM mysql.user;

确保用户允许从客户端主机连接，如 'user'@'192.168.1.50'。

3.4 SSL 设置

检查 MySQL 是否启用 SSL：

SHOW VARIABLES LIKE 'have_ssl';

若为 DISABLED，则需启用 SSL 或在连接时禁用 SSL：

mysqlsh --ssl-mode=DISABLED

3.5 协议选择

使用 mysqlsh 时，注意选择正确的协议：

• X Protocol：端口一般为 33060，支持文档存储和 NoSQL 操作。
• Classic Protocol：端口一般为 3306，适用于传统 SQL 操作。

示例连接命令：

mysqlsh root@localhost:33060

4. 日志分析与高级排查

MySQL 的错误日志通常位于 /var/log/mysql/error.log 或类似路径。查找连接失败的详细信息：

tail -n 50 /var/log/mysql/error.log

常见错误包括：

错误信息	可能原因
Access denied for user 'root'@'192.168.1.50'	认证失败或权限不足
Can't connect to MySQL server on '192.168.1.100'	网络不通或端口未开放
SSL connection error: protocol version mismatch	SSL 配置不一致