Z-Blog启用新模板后页面显示空白的故障排查与修复

启用新模板后页面显示空白（俗称“白屏死机”），通常由模板语法错误、权限限制或依赖缺失引发。需通过错误日志、逐级排查模板文件或调整服务器配置解决。

PHP语法错误
- 场景：模板文件（.php）中存在语法错误（如缺少分号、未闭合括号）。
- 现象：空白页无任何输出，PHP错误日志中记录 Parse error 或 Fatal error。
模板文件缺失或权限不足
- 场景：模板目录（zb_users/theme/新模板名/）未完整上传，或文件权限设置为不可读（如chmod 000）。
- 现象：浏览器开发者工具显示404错误（CSS/JS未加载），或直接返回HTTP 500状态码。
依赖资源冲突
- 场景：模板依赖的插件未启用、函数库未引入（如未调用<?php $zbp->Load(); ?>）。
- 现象：部分功能区域空白，控制台报 Undefined function 或 Uncaught ReferenceError。
内存耗尽或超时
- 场景：模板中存在死循环、递归调用或大数据量查询。
- 现象：页面加载长时间无响应，最终返回空白，PHP日志提示 Allowed memory size exhausted。
编码冲突
- 场景：模板文件保存为UTF-8 BOM格式，导致输出头信息前存在隐藏字符。
- 现象：页面顶部出现空白行，或Header already sent警告。

问题分类	解决步骤
开启错误显示	在`zb_system/function/c_system_base.php`中添加：<br>`error_reporting(E_ALL); ini_set('display_errors', 1);`
检查模板语法	使用命令行工具验证PHP语法：<br>`php -l zb_users/theme/新模板名/template/index.php`
文件权限修复	设置模板目录权限为可读：<br>`chmod -R 755 zb_users/theme/新模板名/`
资源路径修正	检查模板中CSS/JS引用路径是否为相对路径（如`<?php echo $host ?>theme/新模板名/css/style.css`）。
清除缓存	删除Z-Blog缓存目录（`zb_users/cache/`）和浏览器缓存，强制重新编译模板。
内存限制调整	修改`php.ini`中配置：<br>`memory_limit=256M` 和 `max_execution_time=120`。