运行Django测试时OperationalError(1050)表已存在错误的解决方法

以下是针对Django测试时MySQL数据库表重复创建报错的排查和解决步骤：

1. 强制彻底重建测试数据库 #

使用Django内置参数跳过缓存，直接删除并重新创建测试库：

python manage.py test --noinput --recreate-db

若你的Django版本低于3.2（不支持--recreate-db），可手动清理后再运行测试：

# 删除测试库
mysql -u your_username -p -e "DROP DATABASE IF EXISTS test_sepantadb;"
# 创建空测试库
mysql -u your_username -p -e "CREATE DATABASE test_sepantadb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
# 执行测试
python manage.py test --noinput

2. 修正数据库测试配置 #

在项目settings.py中明确测试库的创建规则，禁用缓存机制：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'sepantadb',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_pass',
        'HOST': 'localhost',
        'PORT': '3306',
        'TEST': {
            'NAME': 'test_sepantadb',
            # 强制创建新库，不依赖现有残留
            'CREATE_DB': True,
            # 测试时重新执行所有migrations，而非使用缓存结果
            'MIGRATE': True,
            'COLLATION': 'utf8mb4_unicode_ci',
        },
    }
}

3. 检查并重建migrations文件 #

若migrations存在重复或异常，会导致测试时重复创建表：

• 删除对应app下的migrations文件夹（仅保留__init__.py）
• 重新生成migrations：

  python manage.py makemigrations your_app_name
  

• 执行migrations到主数据库：

  python manage.py migrate
  

• 再次运行测试，确认migrations逻辑正常

4. 排查测试代码中的手动数据库操作 #

• 确保所有测试类继承django.test.TestCase（而非SimpleTestCase），前者会自动处理数据库的创建与销毁
• 检查测试方法或post_migrate信号中是否存在手动执行SQL创建表的代码，这类操作需在测试结束后清理
• 确认未通过@override_settings修改数据库配置，避免测试时误操作主数据库

5. 检查MySQL权限与版本兼容性 #

• 确保数据库用户拥有DROP、CREATE、ALTER、INDEX等完整权限，避免删除或创建库/表时执行不完全
• 若使用MySQL 8.0+，需确保Django版本在3.2及以上，规避版本兼容性导致的数据库清理不彻底问题

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