执行makemigration无异常，migrate却报ValueError：无效整数字面量'null'

我之前也碰到过一模一样的问题——修改模型字段后makemigrations顺利通过，但migrate直接炸这个错，本质上是数据库里的现有数据和你新改的字段类型不兼容导致的，咱们一步步来解决：

先搞清楚问题根源 #

首先你得确认两个关键点：

• 打开这次生成的迁移文件（比如migrations/00XX_update_emails_for_help.py），看看emails_for_help字段是从什么类型改成了什么类型？比如是不是从IntegerField改成了EmailField/CharField？
• 直接查数据库里的setup_user表，看看emails_for_help字段有没有存字符串'null'的记录（注意是带引号的字符串，不是SQL的NULL值）——Django在迁移时试图把这个字符串转成整数，自然就报错了。

针对性解决方案 #

方案一：先修复数据库里的错误数据（最直接） #

1. 先别着急跑迁移，打开Django Shell：

   python manage.py shell
   

2. 导入你的模型，找出有问题的记录：

   from your_app_name.models import Setup_user
   # 找出所有emails_for_help是字符串'null'的记录
   bad_records = Setup_user.objects.filter(emails_for_help='null')
   

3. 把这些记录修正成合法值，比如设置为None（对应SQL的NULL）或者空字符串，根据你的字段定义来：

   for record in bad_records:
       record.emails_for_help = None  # 如果你的字段允许null的话
       # 或者 record.emails_for_help = ''  # 如果字段允许blank的话
       record.save()
   

4. 退出Shell，重新执行迁移：

   python manage.py migrate
   

方案二：修改迁移文件，先处理数据再改字段类型 #

如果是因为字段类型变更（比如从整数改成字符串类字段），自动生成的迁移文件没处理数据转换，你可以手动修改迁移文件：

1. 打开对应的迁移文件，在字段变更操作前添加一个RunPython步骤，先把错误数据修正：

   from django.db import migrations, models
   
   def fix_invalid_emails(apps, schema_editor):
       # 用apps.get_model避免直接引用当前模型，保证迁移兼容性
       Setup_user = apps.get_model('your_app_name', 'Setup_user')
       # 批量修正错误记录
       Setup_user.objects.filter(emails_for_help='null').update(emails_for_help=None)
   
   class Migration(migrations.Migration):
       dependencies = [
           ('your_app_name', '00XX_previous_migration'),  # 这里是你之前的迁移文件名
       ]
   
       operations = [
           # 先执行数据修复
           migrations.RunPython(fix_invalid_emails),
           # 再执行字段变更
           migrations.AlterField(
               model_name='setup_user',
               name='emails_for_help',
               # 这里写你现在的字段定义，比如：
               field=models.EmailField(blank=True, null=True),
           ),
       ]
   

2. 保存后执行迁移：

   python manage.py migrate
   

方案三：重置迁移（谨慎使用，适合开发环境） #

如果之前的迁移有残留问题，或者你搞不清哪一步出问题了，可以尝试重置迁移（生产环境务必先备份数据库！）：

1. 备份你的数据库（重要！）
2. 删除your_app/migrations/目录下除了__init__.py之外的所有文件
3. 重新生成初始迁移：

   python manage.py makemigrations
   

4. 用--fake-initial标记初始迁移已执行（避免重新创建表）：

   python manage.py migrate --fake-initial
   

5. 重新修改Setup_user模型的emails_for_help字段，生成新的迁移并执行：

   python manage.py makemigrations
   python manage.py migrate
   

注意事项 #

• 生产环境操作前一定要备份数据库，避免数据丢失！
• 如果是团队协作，修改迁移文件后要同步给队友，避免迁移不一致。

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