如何从StaticBlock迁移至StructBlock？解决已有页面配置报错问题

需要将已有的StaticBlock修改为StructBlock，原代码如下：

class SomeBlock(blocks.StaticBlock):
    pass

    class Meta:
        ...

修改后代码为：

class SomeBlock(blocks.StructBlock):
    ...

    class Meta:
        ...

但当Wagtail页面已配置该SomeBlock时，会出现报错：

NoneType is not iterable

由于原StaticBlock内部无任何内容，需要编写自定义数据迁移，但查阅Django 4.1的Schema Operations文档后，未找到修改块类型的方法，该如何处理？

Wagtail的StreamField数据存储在JSON字段中，修改块类型本质是更新JSON结构，让旧的StaticBlock数据适配新的StructBlock格式，具体步骤如下：

• 生成空迁移文件
  运行命令创建空的自定义迁移文件：

  python manage.py makemigrations --empty your_app_name
  

• 编写数据转换逻辑
  旧的StaticBlock在StreamField的JSON数据中通常是仅含type字段的结构或空对象，而StructBlock需要对应字段的键值对（即使是空值）。在生成的迁移文件中添加以下逻辑：

  from django.db import migrations
  
  def convert_static_to_struct(apps, schema_editor):
      # 替换为你的页面模型类
      TargetPage = apps.get_model('your_app', 'TargetPage')
      # 替换为你的StreamField字段名
      stream_field_name = 'content'
  
      for page in TargetPage.objects.all():
          updated_stream_data = []
          for block in getattr(page, stream_field_name):
              # 替换为你的块注册名称（通常是类名小写）
              if block['type'] == 'someblock':
                  # 若StructBlock无自定义字段，设为空字典；若有字段，初始化默认值
                  block['value'] = {}
              updated_stream_data.append(block)
          setattr(page, stream_field_name, updated_stream_data)
          page.save()
  
  class Migration(migrations.Migration):
      dependencies = [
          # 替换为上一次迁移的名称
          ('your_app', '000X_previous_migration'),
      ]
  
      operations = [
          migrations.RunPython(convert_static_to_struct),
      ]
  

• 关键注意事项

  • 务必替换代码中的your_app、TargetPage、content、someblock等占位符为实际项目中的对应名称。
  • 如果StructBlock包含必填字段，要在block['value']中设置合法的默认值（比如{'subtitle': ''}），避免页面加载失败。
  • 迁移前必须备份数据库，防止数据损坏。
  • 迁移完成后，清理Wagtail页面缓存，确保页面正常渲染。

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