Django多MySQL库迁移异常：失败却生成表且无法识别的解决咨询

1. 确认多数据库配置与迁移命令正确性 #

• 检查settings.py中的DATABASES配置，确保线上库的别名（比如'prod'）配置完整正确，包括主机、端口、认证信息及数据库名：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.mysql',
          'NAME': 'local_db',
          'USER': 'local_user',
          'PASSWORD': 'local_pass',
          'HOST': '127.0.0.1',
          'PORT': '3306',
      },
      'prod': {
          'ENGINE': 'django.db.backends.mysql',
          'NAME': 'prod_db',
          'USER': 'prod_user',
          'PASSWORD': 'prod_pass',
          'HOST': 'prod_host',
          'PORT': '3306',
      }
  }
  

• 迁移时必须显式指定目标数据库，否则会默认使用default库，执行命令时需加上--database参数：

  python manage.py migrate --database=prod
  

2. 修复迁移记录与实际表的不一致 #

线上库已生成表但django_migrations无对应记录，导致迁移冲突，按以下操作处理：

• 登录线上MySQL库，查看django_migrations表，确认对应APP的迁移文件记录是否存在（比如APP为myapp，迁移文件是0001_initial.py）
• 若记录不存在，执行--fake参数标记迁移已完成，必须指定数据库：

  # 标记单个迁移文件完成
  python manage.py migrate --database=prod --fake myapp 0001_initial
  # 标记该APP所有迁移完成
  python manage.py migrate --database=prod --fake myapp
  # 标记所有APP的迁移完成
  python manage.py migrate --database=prod --fake
  

• 若--fake仍失败，直接手动往django_migrations表插入记录：
  插入字段包含app（APP名称）、name（迁移文件名，如0001_initial）、applied（执行时间，可填NOW()）

3. 排查迁移失败的根本原因 #

之前迁移失败但生成了表，大概率是迁移过程中某一步出错，需定位问题：

• 查看迁移时的错误日志，找到具体失败的迁移步骤
• 对比本地与线上MySQL版本：Django 3.2.3要求MySQL 5.7及以上，若线上版本过低可能导致SQL语法不兼容
• 检查线上数据库用户权限：确保拥有CREATE TABLE、ALTER TABLE等操作权限
• 对比本地与线上表结构：若线上表结构和迁移文件定义不一致，需手动调整线上表结构匹配迁移文件，或生成空迁移同步差异：

  python manage.py makemigrations --empty myapp
  

  然后在生成的迁移文件中用RunSQL执行调整语句：

  from django.db import migrations, models
  
  class Migration(migrations.Migration):
      dependencies = [
          ('myapp', '0001_initial'),
      ]
  
      operations = [
          migrations.RunSQL("ALTER TABLE myapp_mymodel ADD COLUMN new_field INT NULL;"),
      ]
  

  最后执行迁移（指定数据库）：

  python manage.py migrate --database=prod
  

4. 后续迁移规范 #

• 迁移前先在测试库验证，确保迁移文件能正常执行
• 线上迁移前先备份数据库，再执行迁移命令
• 始终使用--database参数指定目标数据库，避免混淆环境

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