Django集成MySQL执行migrate报错：已装mysqlclient仍无法加载MySQLdb

问题详情 #

核心报错 #

django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module.
Did you install mysqlclient?

完整错误栈 #

Traceback (most recent call last):
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/backends/mysql/base.py", line 15, in <module>
    import MySQLdb as Database
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/MySQLdb/__init__.py", line 17, in <module>
    from . import _mysql
ImportError: dlopen(/Users/timo/opt/anaconda3/lib/python3.9/site-packages/MySQLdb/_mysql.cpython-39-darwin.so, 0x0002): symbol not found in flat namespace '_mysql_affected_rows'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/Users/timo/Documents/coding/plegeus/musicians/backend/manage.py", line 22, in <module>
    main()
  File "/Users/timo/Documents/coding/plegeus/musicians/backend/manage.py", line 18, in main
    execute_from_command_line(sys.argv)
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/core/management/__init__.py", line 442, in execute_from_command_line
    utility.execute()
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/core/management/__init__.py", line 416, in execute
    django.setup()
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/__init__.py", line 24, in setup
    apps.populate(settings.INSTALLED_APPS)
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/apps/registry.py", line 116, in populate
    app_config.import_models()
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/apps/config.py", line 269, in import_models
    self.models_module = import_module(models_module_name)
  File "/Users/timo/opt/anaconda3/lib/python3.9/importlib/__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1030, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1007, in _find_and_load
  File "<frozen importlib._bootstrap>", line 986, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 680, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 850, in exec_module
  File "<frozen importlib._bootstrap>", line 228, in _call_with_frames_removed
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/contrib/auth/models.py", line 3, in <module>
    from django.contrib.auth.base_user import AbstractBaseUser, BaseUserManager
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/contrib/auth/base_user.py", line 57, in <module>
    class AbstractBaseUser(models.Model):
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/models/base.py", line 143, in __new__
    new_class.add_to_class("_meta", Options(meta, app_label))
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/models/base.py", line 371, in add_to_class
    value.contribute_to_class(cls, name)
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/models/options.py", line 243, in contribute_to_class
    self.db_table, connection.ops.max_name_length()
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/utils/connection.py", line 15, in __getattr__
    return getattr(self._connections[self._alias], item)
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/utils/connection.py", line 62, in __getitem__
    conn = self.create_connection(alias)
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/utils.py", line 193, in create_connection
    backend = load_backend(db["ENGINE"])
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/utils.py", line 113, in load_backend
    return import_module("%s.base" % backend_name)
  File "/Users/timo/opt/anaconda3/lib/python3.9/importlib/__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "/Users/timo/opt/anaconda3/lib/python3.9/site-packages/django/db/backends/mysql/base.py", line 17, in <module>
    raise ImproperlyConfigured(
django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module.
Did you install mysqlclient?

当前数据库配置（settings.py） #

DATABASES = {
"default": {
    "ENGINE": "django.db.backends.mysql",
    "NAME": "musicians_users",
    "USER": "root",
    "PASSWORD": "",
    "HOST": "localhost",
    "PORT": "3306",
  }
}

环境说明 #

• 基于Django 4.2官方教程配置，此前步骤无异常
• 已通过MySQL CLI确认musicians_users数据库存在
• 已执行pip install mysqlclient安装2.2.0版本，问题仍存在

解决方法 #

方法1：重新编译安装mysqlclient #

报错原因是mysqlclient编译时依赖的MySQL库与系统环境不匹配，卸载后指定MySQL库路径重新编译安装：

# 卸载现有包
pip uninstall -y mysqlclient

# 若使用brew安装MySQL，先配置环境变量（根据你的MySQL安装路径调整）
export PATH="/usr/local/mysql/bin:$PATH"
export DYLD_LIBRARY_PATH="/usr/local/mysql/lib:$DYLD_LIBRARY_PATH"

# 从源码编译安装
pip install mysqlclient --no-binary mysqlclient

方法2：改用mysql-connector-python替代 #

若编译安装遇到困难，可切换到官方维护的mysql-connector：

1. 安装依赖包：

pip install mysql-connector-python

2. 修改settings.py中的数据库引擎：

DATABASES = {
"default": {
    "ENGINE": "mysql.connector.django",  # 替换原有引擎
    "NAME": "musicians_users",
    "USER": "root",
    "PASSWORD": "",
    "HOST": "localhost",
    "PORT": "3306",
    "OPTIONS": {
        "autocommit": True,
    },
  }
}

方法3：使用conda安装mysqlclient #

针对Anaconda环境，直接安装conda维护的适配包：

conda install -c conda-forge mysqlclient

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