如何修复MySQL连接丢失报错system error:1(Python mysql.connector场景)
mysql.connector 触发 SSL BAD_LENGTH 断连修复方案
报错本质
该报错的核心是客户端发起SSL握手时,双方交互的数据包长度不匹配,90%以上场景是本地MySQL服务端未启用SSL、但客户端默认尝试建立SSL连接导致的。
可落地修复步骤
- 高版本mysql.connector直接禁用客户端SSL请求
在数据库连接配置中新增ssl_disabled=True参数,完全跳过SSL握手流程,配置示例:import mysql.connector db_conn = mysql.connector.connect( host="127.0.0.1", port=3306, user="本地数据库用户名", password="本地数据库密码", database="目标操作库名", ssl_disabled=True ) - 低版本mysql.connector移除客户端默认SSL标志
如果使用的mysql.connector版本低于8.0,没有内置ssl_disabled参数,可以通过调整客户端连接标志,关闭默认开启的SSL握手逻辑,示例代码:from mysql.connector import connect, ClientFlag db_conn = connect( host="127.0.0.1", port=3306, user="本地数据库用户名", password="本地数据库密码", database="目标操作库名", # 从默认连接标志中移除SSL开启位,避免主动发起SSL握手 client_flags=[flag for flag in ClientFlag.get_default() if flag != ClientFlag.SSL] ) - 排查服务端SSL配置异常
如果需要保留SSL连接能力,先登录MySQL服务端执行查询,确认SSL运行状态:
若查询结果中-- 查询服务端SSL配置项 SHOW VARIABLES LIKE '%ssl%';have_ssl值为DISABLED或为空,说明服务端未正常加载SSL证书(常见原因是证书文件路径配置错误、文件权限不足),需要修正服务端配置后重启数据库服务,让SSL流程正常建立。 - 修正版本兼容问题
已知mysql-connector-python 8.0.28~8.0.32版本存在SSL握手包长度计算bug,和8.0.34及以上版本的MySQL服务端交互时会直接触发该报错。可通过将客户端依赖升级到8.0.33及以上修复版本解决,也可对齐客户端和服务端的大版本号,避免跨版本兼容异常。
排坑提示
- 本地开发连接本地数据库时,不要随意开启
ssl_verify_cert=True、ssl_verify_identity=True这类证书强校验参数,这类参数会强制客户端发起SSL握手,在服务端未配置SSL的场景下会直接触发断连报错。
内容的提问来源于stack exchange,提问作者tosicann
相关产品推荐
相关产品推荐

