执行makemigrations时Wagtail报错：无法创建site字段

核心原因分析 #

这个错误本质是模型加载顺序冲突：Django初始化模型阶段，你的自定义应用模型引用了wagtailcore.Site，但Wagtail核心模型尚未完成加载；而urls.py中过早导入wagtailadmin_urls会触发Wagtail admin相关表单、模型的提前初始化，进一步加剧了这个顺序问题。

具体解决方案 #

1. 延迟urls.py中的Wagtail路由导入 #

如果根urls.py在模块顶部直接导入wagtailadmin_urls，改成在urlpatterns内部使用字符串路由引用，避免提前触发Wagtail admin的初始化流程：

错误示例：

from wagtail.admin import urls as wagtailadmin_urls

urlpatterns = [
    path('admin/', include(wagtailadmin_urls)),
    # 其他路由...
]

修改后代码：

urlpatterns = [
    path('admin/', include('wagtail.admin.urls')),
    # 其他路由...
]

2. 调整模型中Site的引用方式 #

如果自定义模型直接关联Site，改用字符串模型引用而非直接导入模型类，避免触发过早的模型依赖：

错误示例：

from wagtail.core.models import Site

class MyModel(models.Model):
    site = models.ForeignKey(Site, on_delete=models.CASCADE)

正确示例：

class MyModel(models.Model):
    site = models.ForeignKey('wagtailcore.Site', on_delete=models.CASCADE)

3. 确认INSTALLED_APPS加载顺序 #

确保Wagtail核心应用在自定义应用之前加载，调整INSTALLED_APPS顺序：

INSTALLED_APPS = [
    # Wagtail核心应用优先加载
    'wagtail.contrib.forms',
    'wagtail.contrib.redirects',
    'wagtail.embeds',
    'wagtail.sites',
    'wagtail.users',
    'wagtail.snippets',
    'wagtail.documents',
    'wagtail.images',
    'wagtail.search',
    'wagtail.admin',
    'wagtail',
    
    # Django内置应用
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    # 自定义应用放在最后
    'myapp1',
    'myapp2',
]

4. 重置迁移状态（可选） #

若以上步骤无效，尝试清理现有迁移文件并重新初始化：

# 删除所有迁移文件（保留__init__.py）
find . -path "*/migrations/*.py" -not -name "__init__.py" -delete
find . -path "*/migrations/*.pyc" -delete

# 重新生成初始迁移
python manage.py makemigrations
python manage.py migrate

验证操作 #

完成调整后，重新执行迁移命令：

python manage.py makemigrations

若错误消失则问题解决；若仍报错，需排查是否有其他代码（如信号、自定义表单）提前导入了Wagtail模型或admin模块。

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