无法在页面添加部分原生Django CMS插件求助

问题背景 #

尝试给模板添加部分原生Django CMS插件时，反复弹出“请修正以下错误。”的提示，但表单里看不到任何具体错误。换用项目自带的minimal模板也没用，作为Django新手找不到问题根源，怀疑是Django CMS本身的问题。

排查与修复步骤 #

1. 先修配置文件里的语法错误 #

看你提供的settings.py，邮件配置部分有明显的未赋值变量，这会导致Django初始化异常，进而引发后台表单验证出错：

# Mailing settings
EMAIL_PORT = 
EMAIL_HOST = 
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 
EMAIL_HOST_PASSWORD = os.environ.get('EMAIL_HOST_PASSWORD')

要么把这些邮箱配置补全，要么暂时把这段注释掉，先让项目正常运行起来。

2. 调高日志级别抓详细错误 #

当前日志只记录ERROR级别的信息，很多关键调试信息会被漏掉。修改LOGGING配置，把级别改成DEBUG，同时加上CMS的日志记录：

LOGGING = {
    "version": 1,
    "disable_existing_loggers": False,
    "handlers": {
        "file": {
            "level": "DEBUG",
            "class": "logging.FileHandler",
            "filename": "/debug.log",
        },
        "console": {
            "class": "logging.StreamHandler",
            "level": "DEBUG",
        },
    },
    "loggers": {
        "django": {
            "handlers": ["file", "console"],
            "level": "DEBUG",
            "propagate": True,
        },
        "cms": {
            "handlers": ["file", "console"],
            "level": "DEBUG",
            "propagate": True,
        },
    },
}

改完重启服务，再尝试添加插件，然后看/debug.log或者控制台输出，就能拿到具体的错误信息了。

3. 检查模板的占位符是否正确 #

不管是自定义模板还是minimal.html，都得确保里面有正确的Django CMS占位符，比如：

{% extends "base.html" %}
{% load cms_tags %}

{% block content %}
    {% placeholder "main_content" %}
{% endblock %}

没有正确的占位符，插件根本没法添加到模板里。

4. 确认插件依赖都装全了 #

检查INSTALLED_APPS里的插件是否都完成了数据库迁移和静态文件收集：

• 运行python manage.py migrate，确保所有插件的数据库表都创建好了
• 运行python manage.py collectstatic，保证插件的静态文件能正常加载

5. 清缓存试试 #

有时候缓存会导致奇怪的验证问题：

• 清Django缓存：python manage.py clearcache
• 清浏览器的缓存和Cookie，然后重新登录后台

逐步排查插件冲突 #

如果上面的步骤都没用，就把非核心插件先禁用，一个个排查：

1. 把INSTALLED_APPS里的form_designer、form_designer.contrib.cms_plugins.form_designer_form和cookiebanner注释掉
2. 重启服务后试加原生插件，如果正常了，再逐个把这些插件加回来，找到冲突的那个

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