Wagtail创建页面时设为父页首个子节点出现path重复错误如何解决

报错{'path': ['Page with this Path already exists.']}是treebeard的路径唯一约束触发的冲突，偶发的原因主要有3点：

• post_save信号触发时，创建ListPage的事务还未完全提交，treebeard为新实例分配的初始路径还未完全落地，此时调用move修改路径容易和未提交的状态产生冲突
• 没有限制信号触发范围：move操作本身会触发实例的save动作，导致post_save信号被递归调用，多次修改路径引发冲突
• 并发场景下多个节点同时向同一个父节点插入为第一个子节点，路径分配时出现竞争，生成了重复的路径值

修改信号逻辑即可解决：

1. 使用transaction.on_commit保证移动操作在当前创建实例的事务完全提交后再执行
2. 仅在首次创建实例时触发移动逻辑，避免后续实例更新时重复执行
3. 对父节点加行锁，避免并发操作时的路径竞争

修改后的代码示例：

from django.db import transaction

@receiver(post_save, sender=ListPage)
def move_page(sender, instance, created, **kwargs):
    # 非首次创建场景不执行移动逻辑
    if not created:
        return

    def run_move():
        # 避免move操作触发的save递归调用当前信号
        if hasattr(instance, '_is_moving'):
            return
        instance._is_moving = True
        # 对父节点加行锁，避免并发修改冲突
        parent = instance.get_parent().select_for_update().first()
        if parent:
            instance.refresh_from_db()
            instance.move(parent, pos='first-child')
        delattr(instance, '_is_moving')

    # 等当前事务完全提交后再执行移动
    transaction.on_commit(run_move)

如果并发量较高还是偶发冲突，可以额外增加重试逻辑：

from django.db import transaction, OperationalError
import time

@receiver(post_save, sender=ListPage)
def move_page(sender, instance, created, **kwargs):
    if not created:
        return

    def run_move(retry_times=3):
        try:
            with transaction.atomic():
                if hasattr(instance, '_is_moving'):
                    return
                instance._is_moving = True
                parent = instance.get_parent().select_for_update().first()
                if parent:
                    instance.refresh_from_db()
                    instance.move(parent, pos='first-child')
                delattr(instance, '_is_moving')
        except OperationalError as e:
            if "Path already exists" in str(e) and retry_times > 0:
                time.sleep(0.1)
                run_move(retry_times - 1)
            else:
                raise e

    transaction.on_commit(run_move)

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