Authentication to host ‘127.0.0.1‘ for user ‘root‘ using method ‘caching_sha2

记一次MySQL跨地域连接“握手超时”的完整解决实录

一次真实的跨地域部署踩坑记录，从问题定位到完美解决。

1. 问题诞生：一次寻常的部署与不寻常的报错

最近将内部系统进行跨地域部署，架构很简单：.NET 8开发的API应用放在本地的Windows Server上，MySQL 8.0.4数据库则运行在远程数据中心。部署完成后，一个诡异的现象出现了：

✅ 不涉及数据库的API端点（如登录获取Token）完全正常
❌ 但凡涉及数据库查询的接口，全部返回同样的错误：Got timeout reading communication packets

控制台中的完整错误信息更是耐人寻味：

Authentication to host '127.0.0.1' for user 'root' using method 'caching_sha2_password' failed with message: got timeout reading communication packets (错误代码：1159)

这提示我们：连接能建立，但在认证阶段卡住了。

2. 问题排查：从基础测试到系统化验证

第一步：基础网络诊断

首先在应用服务器上检查到远程数据库的基础连通性：

# 使用PowerShell测试端口连通性Test-NetConnection-ComputerName 127.0.0.1-Port 3306

结果出乎意料：端口是开放的，TCP连接可以建立。这说明不是防火墙或网络不通的基础问题。

第二步：编写系统化测试程序

为了全面诊断问题，我编写了一个能同时测试多种连接策略的程序。这个程序的价值在于它能并行验证不同的解决方案，帮助我们快速找到最优解。

usingMySql.Data.MySqlClient;classTestDbConnection{staticvoidMain(){// 尝试不同的连接字符串string[]connectionStrings={// 方案1: 使用旧认证方式"Server=127.0.0.1;Port=3306;Database=db;Uid=root;Pwd=123123;Connection Timeout=60;Default Command Timeout=120;SslMode=Disabled;AllowPublicKeyRetrieval=true;",// 方案2: 使用最小配置"Server=127.0.0.1;Port=3306;Database=db;Uid=root;Pwd=123123;Connection Timeout=60;",// 方案3: 禁用连接池"Server=127.0.0.1;Port=3306;Database=db;Uid=root;Pwd=123123;Connection Timeout=60;Pooling=false;"};Console.WriteLine("开始测试数据库连接...\n");for(inti=0;i<connectionStrings.Length;i++){Console.WriteLine($"测试连接字符串 #{i+1}:");Console.WriteLine($"------------------------");try{usingvarconnection=newMySqlConnection(connectionStrings[i]);varstartTime=DateTime.Now;connection.Open();varconnectTime=DateTime.Now-startTime;Console.WriteLine($"✅ 连接成功 - 耗时:{connectTime.TotalMilliseconds}ms");Console.WriteLine($"MySQL 版本:{connection.ServerVersion}");// 测试简单查询usingvarcommand=newMySqlCommand("SELECT COUNT(*) FROM mes_dc_electricdata",connection);command.CommandTimeout=30;startTime=DateTime.Now;varcount=command.ExecuteScalar();varqueryTime=DateTime.Now-startTime;Console.WriteLine($"✅ 查询成功 - 数据量:{count}行 - 耗时:{queryTime.TotalMilliseconds}ms");Console.WriteLine();}catch(MySqlExceptionex){Console.WriteLine($"❌ 连接失败 - MySQL错误:{ex.Message}");Console.WriteLine($"错误代码:{ex.Number}");Console.WriteLine($"连接字符串:{connectionStrings[i]}");Console.WriteLine();}catch(Exceptionex){Console.WriteLine($"❌ 连接失败 - 一般错误:{ex.Message}");Console.WriteLine($"连接字符串:{connectionStrings[i]}");Console.WriteLine();}}Console.WriteLine("测试结束，按任意键退出...");Console.ReadKey();}}

3. 深入分析：为什么高延迟网络下认证会失败？

测试结果明确显示：策略都失败了。这让我把注意力集中到了MySQL 8.0的认证机制上。

MySQL认证机制的演进与影响

MySQL 5.x：默认使用mysql_native_password认证（单次往返）
MySQL 8.0+：默认使用caching_sha2_password认证（多次往返）

网络往返次数的巨大影响

认证方式	网络往返次数	低延迟环境	高延迟环境（>30ms）
`mysql_native_password`	1次	几乎无感知	可接受（30-50ms）
`caching_sha2_password`	3-4次	轻微影响	严重问题（100-200ms）

在跨地域网络环境下，每次往返都增加30-50ms延迟，多次往返很容易超过客户端的默认超时设置。

4. 我的完整解决步骤（实测有效）

基于以上分析，我采取了双重措施确保问题彻底解决：

第一步：修改MySQL认证插件（根本解决）

在远程MySQL服务器上执行以下命令：

-- 1. 查看当前认证插件SELECTuser,host,pluginFROMmysql.userWHEREuser='root';-- 2. 修改认证插件为mysql_native_passwordALTERUSER'root'@'%'IDENTIFIEDWITHmysql_native_passwordBY'你的密码';-- 3. 创建专用应用账户（生产环境推荐）略过也可以、直接使用root账户CREATEUSER'app_user'@'%'IDENTIFIEDWITHmysql_native_passwordBY'强密码';GRANTSELECT,INSERT,UPDATE,DELETEONapp_db.*TO'app_user'@'%';-- 4. 刷新权限FLUSHPRIVILEGES;

第二步：重启MySQL服务（关键步骤！）

重要提醒：修改认证插件后，必须重启MySQL服务使更改完全生效！

# Linux系统sudosystemctl restart mysql# 或使用service命令sudoservicemysql restart# Windows系统（服务方式）net stop mysql net start mysql

为什么需要重启：虽然FLUSH PRIVILEGES会重新加载权限表，但某些情况下认证插件的更改需要完全重启服务才能在所有连接上生效，特别是在有活跃连接或连接池的情况下。

第三步：优化连接字符串

在应用程序中使用优化后的连接字符串：

// 生产环境推荐配置stringconnectionString="Server=127.0.0.1;"+"Port=3306;"+"Database=app_db;"+"Uid=app_user;"+// 使用专用账户"Pwd=强密码;"+"Connection Timeout=60;"+// 适当增加连接超时"Default Command Timeout=120;"+// 增加命令超时"SslMode=None;"+// 高延迟环境可考虑禁用SSL"AllowPublicKeyRetrieval=true;"+// 允许公钥检索"Pooling=true;"+// 启用连接池"Min Pool Size=5;"+// 连接池优化"Max Pool Size=50;"+"ConnectionLifeTime=180;";// 连接生命周期

5. 验证结果与测试

完成上述步骤后，我在本地和远程服务器上分别运行测试程序，结果令人满意：

测试策略 #1: ------------------------ ✅ 连接成功 - 耗时: 152ms MySQL 版本: 8.0.44 ✅ 查询成功 - 数据量: 1542 行 - 耗时: 89ms 测试策略 #2: ------------------------ ✅ 连接成功 - 耗时: 168ms MySQL 版本: 8.0.44 ✅ 查询成功 - 数据量: 1542 行 - 耗时: 92ms 测试策略 #3: ------------------------ ✅ 连接成功 - 耗时: 161ms MySQL 版本: 8.0.44 ✅ 查询成功 - 数据量: 1542 行 - 耗时: 95ms

所有三种策略全部成功！这证明：

认证插件修改已生效
重启MySQL服务是必要的
问题得到彻底解决

6. 生产环境完整解决方案

架构最佳实践

专用数据库用户：永远不要在生产环境使用root账户进行应用连接
连接池调优：根据实际并发量调整连接池参数
监控告警：设置连接超时、慢查询的监控告警

.NET Core应用配置

services.AddDbContext<AppDbContext>(options=>{options.UseMySql(Configuration.GetConnectionString("Default"),newMySqlServerVersion(newVersion(8,0,4)),mysqlOptions=>{// 启用重试机制，应对网络波动mysqlOptions.EnableRetryOnFailure(maxRetryCount:5,maxRetryDelay:TimeSpan.FromSeconds(10),errorNumbersToAdd:null);// 设置适当的命令超时mysqlOptions.CommandTimeout(120);// 启用详细日志（调试用）mysqlOptions.EnableDetailedErrors(true);});});