Z-Blog 插件与主题的冲突排查：从白屏到定位的步骤

2026-10-20 · zblog · 阅读 12

摘要

装了插件之后后台打不开、前台白屏，这类问题的排查有固定路径，慌乱重装是最差的选择。第一步：确认是不是插件引起的把 zb_users/plugin/ 下所有插件目录改名，加个 _bak 后缀。再刷新后台，能打开就说明是插件问题。这一步不要动数

装了插件之后后台打不开、前台白屏，这类问题的排查有固定路径，慌乱重装是最差的选择。

第一步：确认是不是插件引起的

把 zb_users/plugin/ 下所有插件目录改名，加个 _bak 后缀。再刷新后台，能打开就说明是插件问题。这一步不要动数据库，纯文件操作，可逆。

插件多的时候逐个试很浪费。一半改名、一半保留，刷新看是否正常，逐步缩小范围。十个插件最多四轮就能定位。

PHP 错误日志一般在 /var/log/php-fpm.log 或站点目录下的 error_log。搜索 Fatal error 和 Stack trace，第一行通常就指向出问题的文件和行号。

换成 Z-Blog 默认主题（default）再试。默认主题不挂钩子、不依赖额外函数，能排除一大半干扰。如果换默认主题后正常了，问题就在主题的 include.php。

排查期间不要反复增删插件：每次启用和停用都会触发配置写入，多次操作后配置可能残留。定位到问题插件后，先停用，再看它写的配置是否适合保留。

所属专题

标签

2026年10月20日 14:59 前后30天 · 点日期看归档

9月20日 9月21日 9月22日 9月23日 9月24日 9月25日 9月26日 9月27日 9月28日 9月29日 9月30日 10月1日 10月2日 10月3日 10月4日 10月5日 10月6日 10月7日 10月8日 10月9日 10月10日 10月11日 10月12日 10月13日 10月14日 10月15日 10月16日 10月17日 10月18日 10月19日 10月20日 10月21日 10月22日 10月23日 10月24日 10月25日 10月26日 10月27日 10月28日 10月29日 10月30日 10月31日 11月1日 11月2日 11月3日 11月4日 11月5日 11月6日 11月7日 11月8日 11月9日 11月10日 11月11日 11月12日 11月13日 11月14日 11月15日 11月16日 11月17日 11月18日 11月19日