Z-Blog 故障排查：404、缓存与附件上传
Z-Blog 最常见三类故障：伪静态 404、缓存不生效与附件上传失败，按先日志后配置再改代码推进。
专题概览
本专题内容导读
1. zblog5 篇
「Z-Blog 故障排查：404、缓存与附件上传」中属于本栏目的文章共 5 篇，合计约 3,781 字，平均每篇 756 字，发布于 2026年10月22日。最近更新的一篇是《Z-Blog 主题升级后样式错乱：CSS 优先级与缓存排查》，建议先读这篇了解最新进展。
- Z-Blog 主题升级后样式错乱：CSS 优先级与缓存排查2026-10-22
先说结论：主题升级后样式错乱，八成不是主题坏了，而是旧 CSS 还在缓存里、或你改过的样式被新版覆盖、或自定义代码与新版选择器冲突。按「缓存 → 覆盖 → 冲突」三步查。 一、先排除缓存 浏览器强刷（Ctrl+F5）或用无痕窗口访问。 检查
- Z-Blog 缓存重建没生效？从机制上理解它的失效顺序2026-10-22
先说结论：「点了重建但页面没变」通常不是缓存没清，而是清了 A 处的缓存，你看到的是 B 处的缓存。Z-Blog 的缓存至少分模板编译、模块/侧栏、配置、浏览器与 CDN 四五层，要按顺序理解。 一、缓存分几层 模板编译缓存：模板文件编译成
- Z-Blog 附件上传失败：类型、大小、权限三重定位2026-10-22
先说结论：附件上传失败基本跑不出三类原因——文件类型被拦、大小超限、目录不可写。按这三层依次排查，比反复重试有效得多。 一、第一层：文件类型 站点设置里有允许上传的扩展名清单，不在清单里的直接拒。 注意扩展名大小写与双扩展名（如 .jpg
- Z-Blog 与 Nginx 缓存冲突：为什么登录后还看到旧页面2026-10-22
先说结论：登录后仍看到旧的未登录页面，本质是整页缓存把「未登录状态」缓存下来并返回给了登录用户。解决方向只有两个：让带 Cookie 的请求绕过缓存，或干脆不对动态页做整页缓存。 一、先确认是「真缓存」还是「假缓存」 无痕窗口与登录窗口分别
- Z-Blog PHP 开启伪静态后文章页 404：从规则到权限的完整排查2026-10-22
先说结论：Z-Blog 开启伪静态后文章页 404，90% 出在三个环节——① 服务器 rewrite 规则没生效；② 后台静态管理中心规则与服务器类型不匹配；③ 目录/文件权限或 .htaccess 未被允许读取。按下面顺序排查，通常 1