运行Flask+MySQL遇OperationalError 2055，求修复及容错方案

这个错误属于MySQL连接的SSL握手异常，核心原因是SSL数据包长度不符合协议规范，导致客户端（Flask应用的mysql.connector）与MySQL服务器的连接被强制中断。常见诱因包括：

• MySQL服务器SSL配置错误（证书/密钥路径无效、权限不足）
• mysql.connector版本与MySQL服务器版本不兼容
• 系统SSL组件（如OpenSSL）版本过低或损坏
• 客户端SSL连接参数设置冲突

1. 临时禁用SSL连接（快速验证） #

在数据库连接参数中添加ssl_disabled=True，跳过SSL握手直接建立连接：

import mysql.connector
from mysql.connector import Error

def connect_db():
    try:
        conn = mysql.connector.connect(
            host="localhost",
            user="your_username",
            password="your_password",
            database="your_db",
            ssl_disabled=True  # 禁用SSL
        )
        return conn
    except Error as e:
        print(f"连接失败: {e}")

如果此方法有效，说明问题出在SSL配置层面，可以进一步排查SSL相关设置。

2. 修复MySQL服务器SSL配置 #

检查MySQL配置文件（Linux为/etc/my.cnf//etc/mysql/my.cnf，Windows为my.ini）中的SSL参数，确保证书、密钥文件路径正确且权限可读：

[mysqld]
ssl-ca=/etc/mysql/ssl/ca.pem
ssl-cert=/etc/mysql/ssl/server-cert.pem
ssl-key=/etc/mysql/ssl/server-key.pem

修改后重启MySQL服务：

• Linux：sudo systemctl restart mysql
• Windows：在服务管理器中重启MySQL服务

3. 匹配客户端与服务器版本 #

升级或降级mysql.connector版本，使其与MySQL服务器版本兼容：

• 升级最新版：pip install --upgrade mysql-connector-python
• 指定兼容版本（如MySQL 8.0对应connector 8.0.x）：pip install mysql-connector-python==8.0.36

4. 检查系统SSL组件 #

• Linux：执行openssl version查看版本，若低于1.1.1建议更新：sudo apt update && sudo apt install openssl（Debian/Ubuntu）
• Windows：确保系统已安装最新补丁，或重新安装OpenSSL组件

1. 数据库连接重试机制 #

封装带重试逻辑的数据库连接函数，捕获连接异常后自动重试，页面刷新时会重新发起连接：

import mysql.connector
from mysql.connector import Error
import time

def get_db_connection(max_retries=3):
    retry = 0
    while retry < max_retries:
        try:
            conn = mysql.connector.connect(
                host="localhost",
                user="your_username",
                password="your_password",
                database="your_db",
                ssl_disabled=True
            )
            return conn
        except Error as e:
            if "Lost connection" in str(e) or "SSL: BAD_LENGTH" in str(e):
                retry += 1
                time.sleep(2)  # 间隔2秒重试
                continue
            raise  # 非目标异常直接抛出
    raise Exception("多次重试后仍无法连接MySQL")

在Flask路由中调用此函数，即使单次连接失败，刷新页面会触发重试。

2. 进程管理工具自动重启 #

生产环境建议使用进程管理工具，当Flask进程崩溃时自动重启：

Linux（Supervisor + Gunicorn） #

1. 安装依赖：sudo apt install supervisor gunicorn
2. 创建Supervisor配置文件/etc/supervisor/conf.d/flask_app.conf：

[program:flask_app]
command=/path/to/venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 app:app
directory=/path/to/your/flask/app
user=your_system_user
autostart=true
autorestart=true  # 进程崩溃自动重启
redirect_stderr=true
stdout_logfile=/var/log/flask_app.log

3. 重启Supervisor：sudo systemctl restart supervisor

Windows（NSSM） #

下载NSSM工具，将Flask应用注册为系统服务，配置服务属性中的"失败时重启"选项，确保进程崩溃后自动重启。

内容的提问来源于stack exchange，提问作者yubin