寻求Wagtail 6.4中dumpdata与loaddata可用示例及导入错误解决方法

环境搭建 #

mkdir wagtail-example
wagtail start wexample wagtail-example/
cd wagtail-example/
uv init && rm hello.py
# 将wagtail版本从6.3更新为6.4
nvim requirements.txt
uv add -r requirements.txt
# 删除重复依赖定义，优先使用pyproject.toml
rm requirements.txt
uv run manage.py migrate
uv run manage.py createsuperuser
uv tree --depth 1

环境依赖输出：

Resolved 33 packages in 0.65ms
wagtail-example v0.1.0
├── django v5.1.6
└── wagtail v6.4.1

使用默认SQLite数据库，运行正常。

数据导出尝试 #

首先执行基础导出命令：

uv run manage.py dumpdata > data.json

同时尝试了优化后的导出命令：

uv run manage.py dumpdata --natural-foreign --indent 2 \
                        -e contenttypes -e auth.permission \
                        -e wagtailcore.groupcollectionpermission \
                        -e wagtailcore.grouppagepermission -e wagtailimages.rendition \
                        -e sessions > data.json

数据导入操作 #

导出完成后执行以下步骤：

# 删除旧数据库
rm db.sqlite3
uv run manage.py migrate --run-syncdb
uv run manage.py loaddata data.json

执行loaddata时出现错误：

django.db.utils.IntegrityError: Problem installing fixture '~/src/wagtail-example/data.json': Could not load wagtailsearch.IndexEntry(pk=1): constraint failed

问题原因：migrate --run-syncdb会自动创建根页面和首页，占用初始主键，同时生成对应的搜索索引条目，导致导入时主键冲突。

可靠的使用方法 #

方案一：优化导出命令，排除冲突模型 #

导出时额外排除wagtailsearch.IndexEntry，同时使用--natural-primary确保数据使用自然键而非硬编码主键，降低冲突概率：

uv run manage.py dumpdata --natural-foreign --natural-primary --indent 2 \
    -e contenttypes -e auth.permission \
    -e wagtailcore.groupcollectionpermission \
    -e wagtailcore.grouppagepermission -e wagtailimages.rendition \
    -e sessions -e wagtailsearch.IndexEntry \
    # 替换为你的自定义app名称，只导出业务数据
    wexample > data.json

如果需要导出所有Wagtail数据（除冲突项），去掉末尾的app名称即可。

方案二：导入前清理自动生成的初始数据 #

1. 执行migrate后，不要删除数据库，直接进入Django shell清理初始数据：

uv run manage.py shell

在shell中执行：

from wagtail.models import Page
from wagtail.search.models import IndexEntry

# 删除自动创建的首页和根页面
home_page = Page.objects.get(url_path='/home/')
home_page.delete()
root_page = Page.objects.get(pk=1)
root_page.delete()

# 删除所有自动生成的搜索索引条目
IndexEntry.objects.all().delete()

2. 退出shell后执行导入命令：

uv run manage.py loaddata data.json

方案三：导出前清理初始数据再导出 #

如果是从干净的环境导出数据，先删除自动创建的首页和根页面，再执行导出命令，这样导出的数据中不会包含这些初始条目，导入时就不会冲突：

# 进入shell删除初始页面和索引
uv run manage.py shell

执行和方案二中相同的清理代码，然后退出shell，再执行导出命令，最后导入到新环境时直接migrate后执行loaddata即可。

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