无法从cms.models.fields导入PlaceholderRelationField的解决求助

核心原因 #

PlaceholderRelationField 在 django-cms 3.7 及以上版本中已被移除，替换为 PlaceholderField 或直接通过 Placeholder 模型关联。报错本质是django-cms与djangocms-blog版本不兼容，或残留依赖导致的版本冲突。

解决步骤 #

• 严格匹配版本兼容性
  明确两者的版本对应关系：

  • django-cms 3.6.x 需搭配 djangocms-blog 3.x 系列（如 3.10.0）
  • django-cms 3.7+ 需搭配 djangocms-blog 4.x 及以上版本
    执行pip freeze查看当前版本，若不匹配则卸载重装：

  pip uninstall django-cms djangocms-blog -y
  pip cache purge
  # 示例：安装兼容的版本组合
  pip install django-cms==3.6.0 djangocms-blog==3.10.0
  

• 清理项目残留并验证配置

  1. 确保INSTALLED_APPS中djangocms_blog的顺序在django-cms核心app之后：

     INSTALLED_APPS = [
         # Django默认应用
         'django.contrib.admin',
         'django.contrib.auth',
         # Django CMS核心应用
         'cms',
         'menus',
         'treebeard',
         'sekizai',
         # djangocms-blog
         'djangocms_blog',
         # 其他插件
     ]
     

  2. 运行迁移确保数据库结构同步：

     python manage.py migrate
     

• 排查冲突因素

  • 检查项目自定义代码或第三方插件，是否存在手动导入PlaceholderRelationField的情况，若有则替换为PlaceholderField调整关联逻辑。
  • 暂时禁用其他CMS第三方插件，逐个启用排查是否存在插件冲突。

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