CKAN 2.7.2自定义主题my_theme触发PluginNotFoundException的解决咨询

我之前维护CKAN 2.7.x实例的时候也踩过一模一样的主题插件加载坑，结合你的CentOS 7.4环境和已经按手册安装的前提，给你梳理几个高概率解决的排查方向：

1. 先确认插件的命名与注册完全正确 #

CKAN对插件的命名和entry point配置要求非常严格，差一个字符都不行：

• 打开主题插件根目录下的setup.py，检查entry_points部分是否准确指向了插件类：

  entry_points='''
      [ckan.plugins]
      my_theme = my_theme.plugin:MyThemePlugin
  ''',
  

• 同时确认my_theme/plugin.py里的插件类确实叫MyThemePlugin，并且正确继承了ckan.plugins.SingletonPlugin，还实现了IConfigurer接口（主题插件必须靠这个接口覆盖模板和静态文件）：

  from ckan.plugins import SingletonPlugin, implements, IConfigurer
  
  class MyThemePlugin(SingletonPlugin):
      implements(IConfigurer)
  
      def update_config(self, config):
          # 在这里指定主题的模板和静态文件路径
          pass
  

2. 验证插件是否真的安装到了CKAN的虚拟环境中 #

CentOS上的CKAN几乎都是用虚拟环境部署的，很容易出现「全局安装了插件，但CKAN运行的虚拟环境没装」的情况：

• 先激活CKAN的虚拟环境（默认路径是/usr/lib/ckan/default/bin/activate，如果你的安装路径不同请替换）：

  source /usr/lib/ckan/default/bin/activate
  

• 执行pip list | grep my_theme，如果看不到你的插件，说明没装对，重新在虚拟环境下安装插件：

  cd /path/to/your/my_theme
  pip install -e .
  

3. 检查CKAN配置文件的插件列表与权限 #

• 打开CKAN的生产配置文件（默认是/etc/ckan/default/production.ini），找到ckan.plugins一行，确认my_theme已经添加进去，并且没有拼写错误：

  ckan.plugins = stats text_view image_view recline_view my_theme
  

• 还要确保配置文件的权限正确，CKAN的运行用户（通常是apache或者ckanuser）要有读取权限：

  chown ckanuser:ckanuser /etc/ckan/default/production.ini
  chmod 644 /etc/ckan/default/production.ini
  

4. 清理CKAN缓存并重启服务 #

CKAN会缓存插件元数据，有时候即使插件装好了，缓存没更新也会报错：

• 在激活虚拟环境的状态下，清理webassets缓存：

  paster --plugin=ckan webassets clean -c /etc/ckan/default/production.ini
  

• 然后重启CKAN的运行服务，如果是用Apache部署的：

  systemctl restart httpd
  

如果是用uWSGI的话：

systemctl restart uwsgi

5. 查看CKAN日志定位具体错误 #

如果上面的步骤都没用，直接看日志找根源是最有效的：

• CentOS上CKAN的错误日志通常在/var/log/httpd/error_log或者/var/log/ckan/default.log里，打开日志搜索PluginNotFoundException或者ImportError，会看到更详细的错误信息，比如「找不到my_theme模块」或者「插件类缺失」，根据日志提示针对性修复。

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