thinkphp页面空白主因是php错误被屏蔽、web根目录未设为public、runtime权限不当及伪静态规则失效；需开启display_errors、将root指向public、仅赋予runtime写权限、用try_files替代if重写。
Ubuntu部署ThinkPHP后页面空白，不是代码出错，而是环境链路中某处没接通——最常见的是PHP错误被屏蔽、Web根目录没指向public、runtime不可写，或Nginx伪静态规则失效。按顺序排查这四点，90%以上能恢复。
让PHP错误直接显示出来
ThinkPHP默认不输出错误，白屏其实是“有错不吭声”。光改APP_DEBUG=true不够，必须让PHP本身把报错打到浏览器：
- 编辑
/etc/php/*/fpm/php.ini（如/etc/php/8.2/fpm/php.ini），把display_errors = Off改为On，同时确认error_reporting = E_ALL（不能是带~E_NOTICE的过滤写法） - 修改后执行
sudo systemctl restart php8.2-fpm nginx（版本号按实际调整） - 如果找不到配置位置，临时在
public/index.php最开头（<?php之后第一行）加两行：ini_set('display_errors', '1'); error_reporting(E_ALL);
调试完务必删掉
确保网站根目录指向public子目录
ThinkPHP 6+ 强制要求Web服务器的root必须落在public/下，设成项目根目录（含app、config）会导致自动加载失败，直接白屏且无提示：
- 检查Nginx配置（通常在
/etc/nginx/sites-enabled/your-site），确认server块里有：root /var/www/your-project/public;（末尾分号不能漏） - 确认
public/index.php真实存在，权限至少644 - 别用
php think run测试——它走CLI模式，和Web环境完全隔离
给runtime目录正确赋权
框架启动时需在runtime/下生成日志、缓存、模板编译文件。给整个项目递归755不仅无效，还可能触发安全警告：
- 只对
runtime及其子目录赋权：sudo chmod -R 775 runtime - 确保属主与PHP-FPM进程用户一致（Ubuntu通常为
www-data）：sudo chown -R www-data:www-data runtime - 刚部署建议先删掉整个
runtime目录，让框架重新生成干净缓存
替换Nginx伪静态规则：用try_files，别用if
老式if (!-e $request_filename) { rewrite ... }在Ubuntu+Nginx组合下极易导致$_SERVER['PATH_INFO']为空，ThinkPHP 8.0依赖它解析路由，一空就静默失败：
- 删除所有
if重写块 - 在
location / { }里写标准规则：try_files $uri $uri/ /index.php?$query_string; - 特别注意：漏掉
$query_string会导致GET参数丢失，控制器因缺参而退出，响应为空
不复杂但容易忽略。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
