如何使Django 4.2兼容MySQL 5.1并在Debian 12正常运行？

方案一：修复MySQL Connector/Python的兼容性错误 #

你遇到的1193 Unknown system variable 'default_storage_engine'错误，是因为MySQL5.1不存在这个系统变量，而新版MySQL Connector/Python在初始化连接时会尝试设置它。通过自定义Django数据库后端可以绕过这个问题：

1. 在你的Django项目中创建自定义后端文件，比如myapp/backends/mysql/base.py：

from django.db.backends.mysql.base import DatabaseWrapper as OriginalConnectorWrapper
from django.db.backends.mysql.operations import DatabaseOperations as OriginalConnectorOps

class DatabaseOperations(OriginalConnectorOps):
    def _get_default_storage_engine(self):
        # 跳过获取default_storage_engine，避免触发错误
        return None

class DatabaseWrapper(OriginalConnectorWrapper):
    ops_class = DatabaseOperations

    def init_connection_state(self):
        # 重写连接初始化逻辑，移除对default_storage_engine的设置
        cursor = self.cursor()
        try:
            # 仅保留必要的字符集和SQL模式设置
            cursor.execute("SET NAMES 'utf8mb4'")
            cursor.execute("SET sql_mode='STRICT_TRANS_TABLES'")
        finally:
            cursor.close()

2. 修改settings.py中的数据库配置，指向自定义后端，并保留use_pure=True参数：

DATABASES = {
    'default': {
        'ENGINE': 'myapp.backends.mysql',
        'NAME': 'your_db_name',
        'USER': 'your_readonly_user',
        'PASSWORD': 'your_password',
        'HOST': 'db_host',
        'PORT': '3306',
        'OPTIONS': {
            'use_pure': True,
            # 添加只读配置，增强安全性
            'read_only': True,
        },
    }
}

方案二：在Debian12上适配旧版mysqlclient #

mysqlclient 2.0.x是最后支持MySQL5.1的版本，你可以手动安装该版本并适配Django后端：

1. 安装编译依赖：

sudo apt-get install gcc python3-dev default-libmysqlclient-dev

2. 指定版本安装mysqlclient：

pip install mysqlclient==2.0.3

3. 同样创建自定义后端以移除不兼容的设置：

from django.db.backends.mysql.base import DatabaseWrapper as OriginalMysqlclientWrapper

class DatabaseWrapper(OriginalMysqlclientWrapper):
    def init_connection_state(self):
        cursor = self.cursor()
        try:
            # MySQL5.1使用storage_engine而非default_storage_engine
            cursor.execute("SET storage_engine=InnoDB")
            cursor.execute("SET NAMES 'utf8mb4'")
            cursor.execute("SET sql_mode='STRICT_TRANS_TABLES'")
        finally:
            cursor.close()

4. 修改settings.py中的ENGINE为这个自定义后端路径即可。

额外注意事项 #

• 确保数据库用户仅拥有只读权限（通过GRANT SELECT等语句配置），既符合业务需求也降低安全风险。
• 先在Debian12测试环境中验证连接、查询等核心操作，确认无误后再迁移生产环境。
• 避免升级mysqlclient或MySQL Connector/Python到更高版本，防止再次出现兼容性问题。

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