单台设备连接数据库caching_sha2_password认证失败的问题咨询
单设备MySQL连接caching_sha2_password认证失败(Reading from the stream has failed)修复流程
故障前提说明
同部署环境下10台设备统一安装业务程序、配置相同数据库连接参数,其中9台可正常完成数据库连接,仅单台设备触发报错,可初步排除数据库服务端权限配置、认证插件配置、全局网络策略的问题,故障根因锁定在异常设备本地,按以下优先级排查修复即可:
排查与修复步骤(按优先级从高到低执行)
- 第一优先级:排查本地流量传输干扰项
- 临时关闭异常设备上的第三方杀毒软件、系统自带防火墙、全局代理/VPN、SSL中间人抓包工具(如Fiddler、Charles),这类工具会截断MySQL认证阶段的TLS加密握手流,直接触发流读取失败报错
- 校验本地网卡MTU配置:在命令行执行
ping -f -l 1472 数据库服务器IP,如果返回需要分片的提示,就把网卡MTU值调整为1400,解决大尺寸握手包分片传输丢失的问题 - 测试端口连通性稳定性:不要仅靠telnet确认3306端口可连通,用netcat工具连续向数据库3306端口发送测试包,排查网线接触不良、网卡硬件故障导致的偶发丢包——这类偶发丢包刚好落在认证握手阶段,就会触发同类报错
- 第二优先级:核对本地客户端运行环境配置
- 逐版本对比异常设备与正常设备的MySQL驱动版本:caching_sha2_password是MySQL 8.0的默认认证插件,版本低于8.0.11的旧驱动无法完成对应认证流程,会在握手阶段主动断开连接触发报错,直接将异常设备的驱动版本替换为和正常设备完全一致的版本即可
- 检查系统TLS支持配置:caching_sha2_password的认证握手要求客户端支持TLS 1.2及以上版本,如果异常设备是Windows 7等老旧系统,仅默认启用TLS 1.0/1.1会被服务端直接拒绝,在系统注册表启用TLS 1.2支持即可,无需修改服务端配置
- 逐行对比业务程序的连接配置文件:确认没有误将SSL模式设为强制证书校验但本地缺失对应证书,也没有把连接超时时间设置得过短(低于2s的超时会在握手未完成时主动断开流)
- 第三优先级:兜底排障操作
- 以上操作全部排查完成仍报错的,执行系统网络栈重置命令:
netsh int ip reset、netsh winsock reset,重启设备后重试连接,解决Winsock被恶意软件篡改导致的流传输异常 - 不建议为了单台设备故障,修改数据库服务端的认证插件配置(将caching_sha2_password替换为旧版mysql_native_password),这类修改会影响所有正常运行的连接,引入全局风险
- 以上操作全部排查完成仍报错的,执行系统网络栈重置命令:
内容的提问来源于stack exchange,提问作者FoxChiffa
相关产品推荐
相关产品推荐

