thinkphp部署后页面空白主因是php错误被屏蔽、web根目录未设为public、runtime权限配置不当及伪静态规则失效；需开启display_errors、将根目录指向public、仅赋予runtime写权限、替换if重写为try_files规则。
ThinkPHP部署后页面空白，不是框架坏了，而是关键配置没对上——错误被屏蔽、入口目录错位、缓存写不了、伪静态失效，这四类问题占了九成以上。直接暴露报错、切对public目录、锁死runtime权限、换掉老旧重写规则，基本就能恢复。
打开错误显示，让报错浮出水面
ThinkPHP默认关掉错误输出，白屏其实是“有错不吭声”。光改app_debug => true不够，必须让PHP本身把错误打出来：
- 找到php.ini或宝塔中对应站点的PHP配置文件，把
display_errors = Off改成On - 同时确认
error_reporting = E_ALL（不能是E_ALL & ~E_NOTICE这类过滤写法） - 改完一定要点「保存」+「重启PHP服务」，只重载配置不生效
- 实在找不到配置位置，临时在
public/index.php最开头加两行：error_reporting(E_ALL);<br>ini_set('display_errors', '1');（上线前务必删掉）
Web根目录必须指向public子目录
ThinkPHP 6+ 强制要求Web服务器的DocumentRoot落在public/下，而不是项目根目录（含app、config、vendor那层）。设错会导致自动加载器路径崩坏，直接Fatal error: Class 'think\App' not found且不报错。
- 宝塔用户：网站 → 设置 → 根目录 → 改为
/www/wwwroot/your-site/public - Nginx手动配置：检查
server块里的root指令，必须是root /path/to/your-project/public;（末尾分号不能漏） - 确认
public/index.php真实存在，权限至少644 - 别用
php think run测试——它走CLI模式，和Web环境完全隔离
runtime目录要可写，但只限它自己
ThinkPHP运行时生成日志、缓存、模板编译文件，全靠runtime/目录。给整个项目递归755不仅无效，还可能引发安全警告。
- 只对
runtime及其子目录赋权：chmod -R 775 runtime - 确保属主与PHP进程用户一致：宝塔默认是
www，执行chown -R www:www runtime - 检查
runtime/log/下是否有按日期命名的日志文件，没有说明不可写或日志类型被设成test - 如果刚部署，建议先删掉整个
runtime目录，让框架重新生成干净缓存
Nginx伪静态别用if，改用try_files
老式if (!-e $request_filename) { rewrite ... }写法在Windows和部分Nginx版本下极易导致$_SERVER['PATH_INFO']为空，ThinkPHP 8.0依赖它解析路由，一空就静默失败。
- 删除所有
if重写块，在location / { }里写标准规则：try_files $uri $uri/ /index.php?$query_string; - 若部署在二级目录（如
http://domain.com/myapp/），需同步调整location匹配路径和fastcgi_param SCRIPT_NAME - Apache用户请确认
.htaccess未被宝塔误删，且mod_rewrite已启用 - 宝塔Nginx用户：站点设置 → 伪静态 → 直接选「thinkphp」，别留空或选错规则
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
