Django CMS中create_page_content API重复创建记录的解决方案

在使用Django CMS进行页面管理时，开发人员可能会遇到一个常见问题：通过API创建页面内容时，系统会意外地创建重复的PageContent和PageUrl记录。这个问题不仅会导致数据库中出现冗余数据，还会引发"MultipleObjectsReturned"异常，影响页面设置功能的正常使用。

问题现象

当通过Django CMS的API创建页面内容时，系统会生成两个PageContent记录：

1. 一个记录包含API调用中指定的模板
2. 另一个记录则使用默认的INHERIT模板

同时，还会创建两个完全相同的PageUrl记录。这种重复创建行为会导致在尝试访问页面设置时抛出"get() returned more than one PageUrl"异常。

问题根源

经过分析，这个问题源于API使用方式不当。具体来说：

1. create_page函数已经自动创建了一个PageContent对象
2. 随后又显式调用了create_page_content函数，导致第二个PageContent对象被创建
3. 每个PageContent对象的创建都会触发相应的PageUrl记录生成

解决方案

正确的做法应该是：

1. 首先创建或获取页面对象，注意要提供created_by参数
2. 使用page.pagecontent_set(manager="admin_manager").latest_content()获取现有的内容对象
3. 只有在确实没有内容对象的情况下，才手动创建PageContent对象
4. 从获取的内容对象中取得占位符

示例代码如下：

# 创建或获取页面
parent_page = self.get_parent_page(parent_path)
node_parent = parent_page.node if parent_page else None
draft_page = Page.objects.filter(
    pagecontent_set__title=page_title, 
    node__parent=node_parent
).first()

main_page = draft_page if draft_page else create_page(
    page_title, 
    template, 
    language, 
    parent=parent_page, 
    created_by=james_user
)

# 获取现有内容而非创建新内容
page_content = main_page.pagecontent_set(manager="admin_manager").latest_content()
if not page_content:
    page_content = create_page_content(
        language=language,
        title=page_title,
        page=main_page,
        slug=main_page.get_slug(language),
        created_by=james_user
    )

# 获取占位符
placeholders = Placeholder.objects.get_for_obj(page_content)

临时解决方案

如果已经出现了重复记录，可以通过以下方式临时修复：

# 删除重复的PageUrl记录
dupe_pageurl_record = PageUrl.objects.filter(
    page_id=main_page.pk,
    language=language
).first()
dupe_pageurl_record.delete()

最佳实践建议

1. 在使用API前，充分了解每个函数的完整行为
2. 对于关键操作，先检查是否已有相关记录存在
3. 在生产环境部署前，进行充分的测试
4. 定期检查数据库中的记录，确保没有意外的重复数据

Django CMS团队已经意识到这个问题，并计划在未来版本中改进create_pagecontent函数的行为，使其能够自动检查现有内容对象，避免重复创建。在此之前，开发人员应按照上述解决方案来避免问题的发生。