后台白屏与模板排错实战

1. zblog4 篇

「后台白屏与模板排错实战」中属于本栏目的文章共 4 篇，合计约 4,216 字，平均每篇 1,054 字，发布于 2026年10月21日。最近更新的一篇是《后台一进去就白屏，先看这两个地方再动手改代码》，建议先读这篇了解最新进展。

1. 后台一进去就白屏，先看这两个地方再动手改代码2026-10-21

   上周有个读者的站，后台一进就白屏，连登录框都不给看。他把 PHP 错误日志截图发过来，第一行是 Fatal error: Call to undefined function，路径指着他自己往 include.php 里加的那行。 这种我见

2. 模板改错文件没反应：Z-Blog 模板层级的加载顺序理一遍2026-10-21

   上周有人把 index.php 改了三遍，前台一点没变。我让他把改的那段发过来，看了一眼就说：你改的是列表页模板，但他要看的是文章页。 Z-Blog 的模板不是「改哪个文件就影响哪个页面」，它按请求类型挑模板。挑错了，写多少代码都是白写

3. 想在文章页插统计代码，该钩哪个点2026-10-21

   想在文章页正文后面插一段统计代码，或者一个广告位，钩哪个点？我的答案是 Filter_Plugin_ViewPost_Template。它在模板渲染之前触发，你能拿到当前文章的完整对象，也能往模板上下文里塞自定义变量。就这两个能力，够用了

4. Z-Blog 后台 500 排查：先看 error_log，别先改代码2026-10-21

   后台一片白或者 500，最怕的反应是「刚刚改了啥，先撤回」。撤回能解决，但你永远不知道原因。 第一件事：找日志 三个地方按顺序看： 站点根目录 zb_users/log/ 下的日志文件 PHP 的 error_log（主机面板一般能看） 后