You need to enable JavaScript to run this app. 如何修复MySQL连接丢失报错system error:1(Python mysql.connector场景)
优惠活动
大模型
产品
解决方案
定价
更多

如何修复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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 21:15:03