MySQL 连接失败？Windows下 mysqlsh 报错排查

2024-12-28 20:20:26

MySQL 连接故障排查：Windows 下 MySQL Shell 连接失败

在数据库管理过程中，可能遇到一个令人困惑的问题：使用 Linux 上的 mysql 客户端可以成功连接 MySQL 数据库，但在 Windows 系统上，通过 mysqlsh（MySQL Shell）却无法连接，并出现 Access denied 错误。本文深入探讨此问题的原因，并提供一系列可能的解决方案。

问题

一台 Red Hat 系统上的 mysql 客户端能正常连接到 MySQL 数据库服务器，而同一服务器的 admin 用户，在 Windows 机器上尝试使用 mysqlsh 登录时却报错，提示拒绝访问，同时使用 MySQL Workbench 却能正常登录。这提示问题很可能与客户端或连接方式有关，而非用户权限本身的问题。

原因分析

主要问题可能出现在以下几个方面：

身份验证插件 (Authentication Plugin) 差异 ：mysqlsh 和较老的 mysql 客户端可能默认使用不同的身份验证插件。旧的客户端通常默认使用 mysql_native_password，而较新的客户端可能倾向于使用 caching_sha2_password，如果服务端用户使用的身份验证方式与客户端默认不一致就会导致连接失败。从用户提供的 user 表信息来看，admin 用户使用的确实是 mysql_native_password。
网络防火墙 ：虽然用户说关闭了Windows防火墙，但在某些复杂网络环境下，中间网络设备也可能存在防火墙或ACL限制，可能导致 mysqlsh 连接失败，或者与MySQL Workbench使用不同的连接方式，前者更倾向于命令行的TCP/IP协议，后者更灵活些。
字符集差异 ：虽然这个不太常见，不同客户端或MySQL shell连接时的默认字符集如果配置不正确，可能也会导致用户身份验证过程失败。

解决方案

以下是几个可能的解决方案及其操作步骤和代码示例，以帮助解决此问题。

1. 明确指定身份验证插件

最直接的方法是尝试在 mysqlsh 连接时指定 mysql_native_password 插件。通过显式指定身份验证插件，可以强制 mysqlsh 使用与数据库端匹配的身份验证机制。

步骤： 修改 mysqlsh 连接命令，增加 -D 或 --default-auth 参数，强制使用 mysql_native_password。

代码示例：

mysqlsh -h <数据库服务器主机名> -P 3306 -u admin -p'你的密码' -D mysql_native_password

如果能够成功登录，则表明身份验证插件不匹配是问题所在。

2. 修改 MySQL 服务端的身份验证插件

如果持续出现连接问题，可考虑直接在数据库服务器上修改 admin 用户的身份验证插件，使其与 mysqlsh 的默认方式保持一致。一般来说将服务器和所有用户的验证方式都更改为 caching_sha2_password是更好的选择，当然也要评估其潜在的影响。

步骤: 连接到 MySQL 服务器，更新用户身份验证插件，刷新权限。

代码示例:

 ALTER USER 'admin'@'%' IDENTIFIED WITH caching_sha2_password BY '你的密码';
 FLUSH PRIVILEGES;

替换 你的密码为用户实际的密码。完成更改后，应测试 mysqlsh 连接。
特别说明:修改完成需要使用-u root或其他高权限用户再次使用客户端链接服务器,并flush privileges刷新用户权限,以保证更改生效.

3. 排查网络连接

尽管已关闭 Windows 防火墙，但依然应仔细排查网络连接：

端口确认： 使用 telnet 或者 Test-NetConnection 命令测试是否能够到达 3306 端口。如果连接超时或被拒绝，可能存在网络层面的障碍，需要检查网络设置和路由。
代码示例(windows powershell)

Test-NetConnection <数据库服务器主机名> -Port 3306

`Telnet <数据库服务器主机名> 3306`  (注意可能需要安装Telnet Client,如果使用该命令)

中间防火墙或 ACL 限制： 排查连接过程中是否涉及到其它防火墙规则或者网络访问控制列表。如果数据库服务器运行在云平台，需检查相关的安全组规则。
网络路径 : 有的时候路由器设置不正确也可能出现连接的问题，排除中间链路是任何网络排障的重点，有条件的尽可能将机器和服务器直连做测试，以减少排查范围。

4. 安装老版本 mysql 客户端（备选）

如果确实需要旧的 mysql 客户端，可以尝试从 MySQL 官方网站下载 MySQL 社区版（MySQL Community Server）历史版本。安装过程根据不同的操作系统稍有不同。安装完之后，在 bin 目录下可以找到 mysql.exe。如果你的需求就是mysql命令行客户端，则此方案不失为一种更便捷和灵活的备选方案。