按Django-CMS文档配置Apphook后，Django无法识别cms_apps.py文件求助

我来帮你排查这个困扰你的问题，结合Django CMS 3.4的特性，常见的原因和解决办法如下：

• 第一步：确认应用已注册到INSTALLED_APPS
  Django CMS只会扫描已添加到项目settings.py中INSTALLED_APPS的应用里的cms_apps.py文件。你需要先检查aktualnosci应用是否在列表里，如果没有，赶紧加上：

  INSTALLED_APPS = [
      # 其他已注册应用...
      'aktualnosci',
  ]
  

  加完记得重启服务器。

• 第二步：检查Django CMS的URL配置和自动发现
  确保项目根urls.py里正确引入了Django CMS的URL，这是apphook生效的前提：

  from django.conf.urls import include, url
  from cms import urls as cms_urls
  
  urlpatterns = [
      # 其他自定义URL...
      url(r'^', include(cms_urls)),
  ]
  

  另外，如果你的settings.py里手动配置了CMS_APPHOOKS列表，需要把你的Apphook类路径添加进去，否则Django CMS不会自动扫描：

  CMS_APPHOOKS = [
      # 其他已配置的apphook...
      'aktualnosci.cms_apps.Aktualnosci',
  ]
  

• 第三步：核对文件路径和命名
  确认cms_apps.py放在aktualnosci应用的根目录下，文件名拼写完全正确（别写成cms_app.py或者大小写错误），同时应用目录里必须有__init__.py文件（保证这是一个合法的Python包）。

• 第四步：清除Django缓存
  Django CMS会缓存apphook的注册信息，有时候即使修改了代码，缓存也会导致新配置不生效。执行下面的命令清除缓存：

  python manage.py clearcache
  

  如果用了第三方缓存服务（比如Redis、Memcached），也要手动清空对应缓存。

• 第五步：确保服务器彻底重启
  开发服务器要完全停止后再启动（按Ctrl+C终止进程，再重新运行python manage.py runserver）；生产环境的服务器（比如Gunicorn、uWSGI）要确保进程完全重启，避免旧代码仍在运行。

• 第六步：验证文件是否被加载
  你可以在cms_apps.py开头加一行打印语句测试：

  print("✅ cms_apps.py 已被加载！")
  

  启动服务器后看控制台有没有这个输出：

  • 如果没有输出：说明文件根本没被加载，回到前面的步骤检查应用注册和路径问题；
  • 如果有输出但apphook不生效：再检查Aktualnosci类的定义，比如是否正确继承了CMSApp，urls路径是否正确（aktualnosci.urls是否存在），app_name是否和应用名一致。

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