页面空白主因是缓存清理触发框架启动失败，需分层验证：检查错误显示是否开启、public目录及伪静态配置是否正确、runtime目录权限与结构是否完整、APP_DEBUG与缓存机制是否存在冲突。
页面空白不是缓存没清干净，而是清理动作触发了其他配置或环境问题——常见于 runtime 目录权限错乱、伪静态规则失效、错误显示被关闭、或 APP_DEBUG 状态与缓存机制冲突。直接删缓存不等于页面就能恢复，得按链路一层层验证。
先确认是否真由缓存清理引发
执行完 php think clear --all 或手动删了 runtime/ 后立刻白屏，说明问题出在“清完之后框架启动失败”，而非缓存本身。此时要区分两种情况：
- 首页和所有路由都空白 → 通常是入口加载失败（public 目录错位、PATH_INFO 为空、PHP fatal error 被屏蔽）
- 仅部分接口或模板页空白 → 更可能是模板缓存或字段结构缓存未同步清理（
runtime/view/和runtime/schema/没动）
检查错误是否被隐藏
缓存清理后框架重新初始化，若此时 PHP 报错但 display_errors 关着，就会静默白屏。必须让错误浮出来：
- 在
public/index.php最开头加两行：error_reporting(E_ALL); ini_set('display_errors', '1'); - 检查 php.ini 或宝塔 PHP 设置中：
display_errors = On且error_reporting = E_ALL（不能带~E_NOTICE这类过滤） - 改完务必重启 PHP 服务，只重载配置不生效
验证 public 目录和伪静态是否还正常
清理缓存常伴随部署操作，容易误改 Nginx 配置。白屏时优先确认：
立即学习“PHP免费学习笔记（深入）”；
- Nginx 的
root指令是否仍指向/your-project/public？写成项目根目录会导致自动加载器崩坏，报Class 'think\App' not found却不显示 - 伪静态规则是否被覆盖回老旧的
if (!-e $request_filename) { rewrite ... }？TP8 依赖$_SERVER['PATH_INFO']，该写法在多数环境下会清空它，导致路由解析失败、静默空白 - 正确写法是：
location / { try_files $uri $uri/ /index.php?$query_string; }
检查 runtime 目录是否可写且结构完整
缓存清完后，框架需重建 runtime/cache/、runtime/log/、runtime/view/ 等子目录。若权限或属主不对，会卡在初始化阶段：
- 执行
ls -la runtime/，确认cache/、log/、view/存在且非空 - 运行
chmod -R 775 runtime并chown -R www:www runtime（宝塔默认用户为 www） - 临时删掉整个
runtime目录，再访问一次页面，看框架能否自动生成干净结构
排除 APP_DEBUG 与缓存状态冲突
如果刚清完缓存又切回 APP_DEBUG = true，某些缓存逻辑（如路由、配置）会跳过生成步骤，但模板或模型缓存可能残留旧逻辑，造成行为不一致：
- 检查
config/app.php和.env，确保app_debug值明确且无冲突 - 若需调试，用
define('THINK_ROUTE_CACHE', false)临时禁用路由缓存，比反复开关 APP_DEBUG 更精准 - 修改配置后，别忘了执行
php think config:cache（需 APP_DEBUG=false）并确认runtime/config.php已更新
