ZBlogCMS 文章发布成功前台不显示如何处理

学完这篇，你能按「状态 → 时间 → 链接 → 缓存 → 插件主题 → 报错日志」的顺序，把 ZBlogPHP「文章发布成功但前台不显示」的问题定位到具体一步并修好。

第一步：先确认文章状态是「公开」而不是草稿

这一步要做什么：排除最low但最高频的原因——文章根本没真正发布。做完你能明确知道文章在数据库里是不是「可见」状态。

登录后台 /zb_system/login.php，进入左侧菜单「文章管理」，看列表里这篇文章的「状态」列。如果是「草稿」或「待审核」，前台就是不显示。

点进文章编辑页，看右侧「状态」下拉框，选成「公开」，再点右上角「提交」（修改时按钮会写「提交」而不是「发布」）。

注意：后台提示「发布成功」只代表写入数据库成功，不代表文章已公开。草稿和待审核状态在被审核前不会出现在前台列表。

第二步：检查发布时间和所属分类

这一步要做什么：确认文章的发文时间没有落在未来，也没被分到前台不展示的分类。

在文章编辑页左侧找到「发布时间」字段（在标题下方的折叠区里，可能显示为「时间」），把它改成一个已经过去的时间，比如当前时间往前 10 分钟，然后提交。

再看「分类」字段：如果这篇文章挂在某个分类下，而这个分类在你主题设置里被设置成「首页不显示」，那首页看不到它是正常的。把分类改成「默认分类」测试一下。

注意：ZBlogPHP 的时间字段格式是 2024-06-01 10:30:00，手动改时别漏掉秒，否则可能被当成无效时间。

第三步：直接访问文章真实链接，判断是「不显示」还是「404」

这一步要做什么：区分「列表页过滤掉了」和「文章页本身打不开」两类完全不同的问题。

在后台文章管理列表里，鼠标悬停在文章标题上，看浏览器左下角显示的 URL；或者点「查看」按钮。把这个 URL 复制出来，粘到浏览器地址栏直接访问。

• 能打开 → 说明文章正常，问题出在首页/列表页的调用或缓存，跳到第四步。
• 提示 404 或其他错误 → 多半是伪静态规则没生效。Apache 要确认根目录有 .htaccess 且 AllowOverride All 已开启；Nginx 要在站点配置里加 ZBlogPHP 官方的 rewrite 规则，改完执行 nginx -t && nginx -s reload。

第四步：清掉三层缓存

这一步要做什么：把 ZBlogPHP 自身缓存、插件缓存、浏览器/CDN 缓存全部清一遍。做完刷新前台再看。

1. 后台首页（点左上角站点名回到后台首页），找到「清空缓存并重新编译模板」按钮，点它。
2. 左侧「应用中心」→「插件管理」，如果启用了「静态化」「缓存」「Redis/Memcached」这类插件，先「停用」它们，再回前台刷新。
3. 浏览器按 Ctrl+F5（Mac 是 Cmd+Shift+R）强制刷新；如果站点套了 CDN（又拍云、七牛、Cloudflare），到 CDN 控制台做一次「刷新缓存 / 全站刷新」。

注意：只清浏览器缓存往往不够，ZBlogPHP 的模板编译缓存存在 /zb_users/cache/ 目录，必须走后台的「清空缓存并重新编译模板」才会重建。

第五步：排查主题模板与主题设置

这一步要做什么：确认是主题把文章「藏」起来了，还是模板文件缺失导致渲染失败。

到「应用中心」→「主题管理」，先切换到系统自带的默认主题（如 default），回前台刷新。如果默认主题下文章能显示，就是你现在用的主题的问题：

• 主题设置里可能有「首页显示分类」「首页排除分类ID」这类选项，去「主题管理」→ 对应主题的「设置」页检查。
• 用 FTP 或主机文件管理器进 /zb_users/theme/你的主题名/template/，确认 index.php、post-single.php 这类模板文件是否齐全。

第六步：开启调试模式看真实报错

这一步要做什么：当前面都排不出问题时，让 ZBlogPHP 把错误信息直接打出来。

编辑 /zb_users/c_option.php，找到 'ZC_DEBUG_MODE' => false, 这一行，把 false 改成 true，保存后刷新前台页面。这时页面顶部会显示 PHP 报错或 SQL 报错，根据提示定位（常见是某个插件调用了不存在的函数，或数据表前缀写错）。

注意：排查完务必把 ZC_DEBUG_MODE 改回 false，否则报错信息会暴露给所有访客，存在安全风险。

小结

• 「发布成功」≠「已公开」：先查状态是不是草稿/待审核。
• 未来时间 + 前台不展示的分类，是第二高频原因。
• 直接访问文章真实 URL，能快速区分是列表问题还是 404 问题。
• 缓存有三层：ZBlogPHP 编译缓存、插件缓存、浏览器/CDN，一个都别漏。
• 换回默认主题能一秒判定是不是主题的锅。
• 最后手段是开 ZC_DEBUG_MODE 看报错，但记得改回去。