Django模型迁移：添加on_delete后仍缺失预期字段求助

问题情况 #

编写boards/models.py模型代码时，运行python manage.py makemigrations触发TypeError，提示ForeignKey缺少on_delete参数。添加该参数后迁移成功，但未生成预期的“Add field topic to post”和“Add field updated_by to post”步骤。

原模型代码 #

from django.db import models
from django.contrib.auth.models import User

class Board(models.Model):
    name = models.CharField(max_length=30, unique=True)
    description = models.CharField(max_length=100)

class Topic(models.Model):
    subject = models.CharField(max_length=255)
    last_updated = models.DateTimeField(auto_now_add=True)
    board = models.ForeignKey(Board, related_name='topics')
    starter = models.ForeignKey(User, related_name='topics')

class Post(models.Model):
    message = models.TextField(max_length=4000)
    topic = models.ForeignKey(Topic, related_name='posts')
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(null=True)
    created_by = models.ForeignKey(User, related_name='posts')
    updated_by = models.ForeignKey(User, null=True, related_name='+')

报错信息 #

Traceback (most recent call last):
  File "manage.py", line 22, in <module>
    main()
  File "manage.py", line 18, in main
    execute_from_command_line(sys.argv)
  File "D:\Desktop\myproject\venv\lib\site-packages\django\core\management\__init__.py", line 419, in execute_from_command_line
    utility.execute()
  File "D:\Desktop\myproject\venv\lib\site-packages\django\core\management\__init__.py", line 395, in execute
    django.setup()
  File "D:\Desktop\myproject\venv\lib\site-packages\django\__init__.py", line 24, in setup
    apps.populate(settings.INSTALLED_APPS)
  File "D:\Desktop\myproject\venv\lib\site-packages\django\apps\registry.py", line 114, in populate
    app_config.import_models()
  File "D:\Desktop\myproject\venv\lib\site-packages\django\apps\config.py", line 301, in import_models
    self.models_module = import_module(models_module_name)
  File "C:\Users\Zinkov\AppData\Local\Programs\Python37\lib\importlib\__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1006, in _gcd_import
  File "<frozen importlib._bootstrap>", line 983, in _find_and_load
  File "<frozen importlib._bootstrap>", line 967, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 677, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 728, in exec_module
  File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
  File "D:\Desktop\myproject\myproject\boards\models.py", line 8, in <module>
    class Topic(models.Model):
  File "D:\Desktop\myproject\myproject\boards\models.py", line 11, in Topic
    board = models.ForeignKey(Board, related_name='topics')
TypeError: __init__() missing 1 required positional argument: 'on_delete'

修改后的代码片段 #

board = models.ForeignKey(Board, related_name='topics', on_delete=models.CASCADE)
starter = models.ForeignKey(User, related_name='topics', on_delete=models.CASCADE)

topic = models.ForeignKey(Topic, related_name='posts', max_length=256, on_delete=models.CASCADE)
created_by = models.ForeignKey(User, related_name='posts', on_delete=models.CASCADE)
updated_by = models.ForeignKey(User, null=True, related_name='+', max_length=256, on_delete=models.CASCADE)

原因分析 #

教程里的“Add field”步骤是分多次修改模型产生的：先创建不含topic和updated_by的Post模型，生成初始迁移；之后逐步添加这两个字段，每次添加后生成新的迁移，才会出现对应的“Add field”步骤。

而你是一次性写出了包含所有字段的Post模型，只是因为on_delete参数缺失导致最初无法生成迁移。修复参数后，Django生成的初始迁移会直接创建包含所有字段的Post表，自然不会单独出现“Add field”的步骤。

另外，修改后的代码存在错误：ForeignKey字段不需要max_length参数，这是多余配置，会引发潜在问题，必须删除。

解决方法（复现教程分步迁移） #

如果你想完全复现教程里的分步迁移流程，按以下步骤操作：

• 删除已生成的boards/migrations/0001_initial.py迁移文件，回退到无迁移状态
• 编写初始模型：Post模型只保留message、created_at、updated_at、created_by字段，且所有ForeignKey都加上on_delete=models.CASCADE
• 运行python manage.py makemigrations，生成初始迁移（此时会创建Board、Topic、Post三个模型）
• 给Post模型添加topic字段（带on_delete=models.CASCADE），运行makemigrations，此时会生成“Add field topic to post”的迁移步骤
• 再给Post模型添加updated_by字段（带on_delete=models.CASCADE），运行makemigrations，此时会生成“Add field updated_by to post”的迁移步骤
• 最后运行python manage.py migrate执行所有迁移

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