修改Wagtail迁移文件报错，如何在Heroku部署时自动创建自定义HomePage？

Django和Wagtail的迁移系统靠迁移历史记录跟踪数据库状态。如果你已经运行过migrate应用了0001_initial.py和0002_create_homepage.py，再修改这两个文件会导致本地/Heroku的迁移历史与实际数据库结构不匹配，直接触发服务器错误——这是迁移系统的核心设计，绝对不能这么干。

针对你的修改场景，分两种解决方案 #

场景1：你修改了HomePage的模型字段（比如新增Banner字段、调整内容块） #

1. 恢复原迁移文件：如果已把修改后的迁移提交到版本控制，先回滚到原来的0001和0002版本；如果只是本地修改，直接从备份/版本库恢复这两个文件。
2. 修改HomePage模型：在你的app的models.py里，按需求调整HomePage的字段定义。
3. 生成新迁移：运行python manage.py makemigrations，Django会自动生成一个新的迁移文件（比如0003_update_homepage_fields.py），记录你对模型的修改。
4. 本地测试：运行python manage.py migrate，确认数据库更新正常，HomePage模型能正常使用。
5. 部署到Heroku：只要你在Procfile里配置了release阶段的migrate命令（见下文），Heroku会自动执行所有未应用的迁移，包括这个新的字段更新迁移。

场景2：你修改的是初始HomePage的内容/配置（比如默认标题、预设内容块、站点根页面设置） #

原来的0002_create_homepage.py只在首次部署、数据库为空时运行一次。如果已经创建过HomePage，它不会重复执行。我们需要一个能同时处理「新部署创建修改后的HomePage」和「已有数据库更新现有HomePage」的逻辑：

方法A：创建新的迁移来处理更新/创建

1. 先恢复原0002_create_homepage.py文件。
2. 生成一个空迁移：python manage.py makemigrations --empty your_app_name（把your_app_name换成你的Wagtail app名称）。
3. 打开新生成的迁移文件，替换内容为以下代码（根据你的需求调整字段）：

   from django.db import migrations
   from wagtail.models import Page, Site
   
   def update_or_create_homepage(apps, schema_editor):
       # 获取HomePage模型（用apps.get_model避免直接引用当前模型，兼容迁移历史）
       HomePage = apps.get_model('your_app_name', 'HomePage')
       
       # 检查是否已有HomePage存在
       homepage = HomePage.objects.first()
       if homepage:
           # 更新现有HomePage的内容
           homepage.title = "我的自定义首页"
           homepage.body = "<p>这是预设的首页内容</p>"  # 假设你有body字段
           homepage.save()
       else:
           # 新部署时创建HomePage并设置为根页面
           root_page = Page.objects.get(id=1)  # Wagtail默认根页面ID是1
           homepage = HomePage(
               title="我的自定义首页",
               slug='home',
               body="<p>这是预设的首页内容</p>",
               # 其他需要设置的字段...
           )
           # 添加为根页面的子页面
           root_page.add_child(instance=homepage)
           # 设置为默认站点的根页面
           site = Site.objects.first()
           if site:
               site.root_page = homepage
               site.save()
   
   class Migration(migrations.Migration):
       dependencies = [
           ('your_app_name', '0002_create_homepage'),  # 依赖之前的创建迁移
       ]
   
       operations = [
           migrations.RunPython(update_or_create_homepage),
       ]
   

4. 本地测试：运行python manage.py migrate，现有HomePage会被更新；如果清空数据库重新migrate，会自动创建你修改后的HomePage。
5. 部署到Heroku：migrate命令会自动执行这个新迁移，完美处理两种场景。

方法B：用信号自动处理（更灵活，适合频繁调整初始内容）

如果你需要经常修改首页的预设内容，用Django的post_migrate信号更方便：

1. 在你的app下创建signals.py文件，写入：

   from django.db.models.signals import post_migrate
   from django.dispatch import receiver
   from wagtail.models import Page, Site
   from .models import HomePage
   
   @receiver(post_migrate)
   def create_or_update_homepage(sender, **kwargs):
       # 只处理当前app的迁移
       if sender.name != 'your_app_name':
           return
       
       homepage = HomePage.objects.first()
       if homepage:
           # 更新现有首页内容
           homepage.title = "自定义首页"
           homepage.save()
       else:
           # 新部署时创建首页
           root_page = Page.objects.get(id=1)
           homepage = HomePage(title="自定义首页", slug='home')
           root_page.add_child(instance=homepage)
           # 设置为站点根页面
           site = Site.objects.first()
           if site:
               site.root_page = homepage
               site.save()
   

2. 在app的apps.py里注册信号：

   from django.apps import AppConfig
   
   class YourAppConfig(AppConfig):
       default_auto_field = 'django.db.models.BigAutoField'
       name = 'your_app_name'
   
       def ready(self):
           import your_app_name.signals  # 导入信号模块
   

3. 这样每次运行migrate后，信号都会触发，确保首页是你想要的状态。

修复当前本地的服务器错误 #

如果已经修改了0001和0002并运行过migrate，导致本地报错：

• 开发环境（可重置数据库）：直接删除本地数据库（比如sqlite文件），恢复原迁移文件，然后重新运行python manage.py migrate，从头开始构建数据库。
• 生产环境（不能重置）：不要用--fake命令瞎搞！建议先恢复原迁移文件，然后按上面的方法创建新迁移来修正模型/内容，确保迁移历史和数据库状态一致。

Heroku部署配置：确保自动执行migrate #

在你的项目根目录的Procfile里，添加release阶段的命令，让Heroku在部署时自动运行迁移：

web: gunicorn your_project_name.wsgi
release: python manage.py migrate --noinput

--noinput参数会让migrate自动确认所有操作，避免部署时需要人工交互。

这样每次推送代码到Heroku，平台会先执行release阶段的migrate，再启动web服务，你的修改后的HomePage会自动创建/更新。

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