如何将Wagtail的ContentPage与Folder两种页面类型合并为一种？

我们有两个功能重复的Wagtail页面类型ContentPage和Folder，计划将Folder合并到ContentPage中，以下是初步梳理的实施步骤，求各位补充遗漏或给出优化建议：

初步实施步骤 #

1. 编写迁移脚本

class Migration(migrations.Migration):

    dependencies = [
        ...
    ]

    operations = [
        # 将Folder页面的专属字段复制到ContentPage表中
        migrations.RunSQL(
            """
            INSERT INTO app_contentpage (
                page_ptr_id,
                ...,
                body,
                ...
            ) SELECT
                ...,
                body,
                ...
            FROM app_folderpage;
        """
        ),

        # 更新所有关联django_content_type的表
        # 假设Folder的content_type_id为12，ContentPage为11
        migrations.RunSQL(
            """UPDATE wagtailcore_page SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_modellogentry SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_pagelogentry SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_revision SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_taskstate SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_workflowstate SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailsearch_indexentry SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_workflowcontenttype SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL(
            """UPDATE wagtailcore_task SET content_type_id = 11 WHERE content_type_id = 12;"""
        ),
        migrations.RunSQL("""DELETE FROM app_folderpage;"""),
    ]

2. 重建引用索引
   执行命令：python manage.py rebuild_references_index，此方式比直接修改wagtailcore_referenceindex表更可靠。
3. 移除模型并生成新迁移
   从代码库中删除Folder模型，然后执行：python manage.py makemigrations
4. 清理权限与日志记录
   手动清理或单独创建迁移，删除auth_permission和django_admin_log中关联Folder的content_type_id的记录。
5. 清理ContentType条目
   从django_content_type表中删除所有与app_folder*相关的记录。

补充建议与遗漏点 #

• 数据备份与校验：执行迁移前务必全量备份数据库；迁移完成后要逐一验证ContentPage中新增数据的完整性，包括字段值、页面层级关系是否正常。
• 搜索索引全量更新：虽然已经修改了wagtailsearch_indexentry，但建议额外执行python manage.py update_index，确保搜索索引完全同步，避免旧数据残留或新数据未被索引。
• URL路由验证：检查原Folder页面的访问URL是否能正常指向合并后的ContentPage，避免出现404错误；若有自定义路由逻辑，需同步调整。
• 权限有效性测试：清理auth_permission后，要测试不同角色用户对原Folder页面（现为ContentPage）的访问、编辑权限是否符合预期，防止权限丢失或异常。
• 缓存清理：如果项目使用了Redis、Memcached等缓存服务，需全量清理缓存，避免旧页面类型数据被缓存导致显示异常。
• 第三方依赖检查：排查所有依赖Folder模型的自定义代码、模板或第三方插件，比如模板中{% if page.specific|instanceof:Folder %}这类判断逻辑，需替换为ContentPage的判断规则。
• 迁移原子性保障：建议将迁移中的所有SQL操作包裹在事务中（用BEGIN; ... COMMIT;），或者合并到一个migrations.RunSQL块，确保操作的原子性，避免中途出错导致数据不一致。

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