thinkphp部署后页面空白主因是php错误被静默屏蔽、web根目录未设为public、runtime目录不可写及伪静态规则失效；需依次开启错误显示、校正根目录、赋权runtime、配置重写规则。
PHP网站部署后出现空白页，核心问题通常不是代码本身出错，而是环境配置没对上——错误被静默吞掉、入口路径错位、缓存写不进、重写规则失效。按顺序检查这四点，90%以上能立刻恢复。
让报错直接显示出来
空白页最常见原因是PHP错误被屏蔽了。ThinkPHP默认关掉错误输出，但你得先看到错误，才能解决问题：
- 在 public/index.php 文件最开头（
<?php后第一行）插入两行：
ini_set('display_errors', '1');<br>error_reporting(E_ALL);
- 保存后刷新页面，如果出现红色报错，说明是PHP层问题；如果还是空白，说明错误发生在更早阶段（比如自动加载失败或PHP版本不兼容）
- 上线前务必删掉这两行，生产环境不应暴露错误信息
确认网站根目录指向 public 子目录
ThinkPHP 6+ 强制要求 Web 服务器的根目录必须落在 public/ 下，而不是项目根目录（含 app、config、vendor 的那层）：
- 宝塔用户：站点 → 设置 → 网站目录 → 运行目录选 /public（用下拉菜单选，别手动输）
- Nginx 用户：检查 server 块里的 root 指令，必须是
root /path/to/your-project/public; - Apache 用户：确保 DocumentRoot 指向 public 目录，且 .htaccess 文件存在并生效
- 顺手验证：直接访问
http://你的域名/public/index.php，能打开说明入口路径没问题
检查 runtime 目录是否可写
框架启动时要生成日志、缓存、模板编译文件，全靠 runtime/ 目录。给整个项目递归赋权不仅无效，还可能触发安全警告：
- 执行命令：
chmod -R 775 runtime - 确保属主与 PHP 进程用户一致：宝塔默认是 www，运行
chown -R www:www runtime - 删除整个 runtime 目录，让框架重新生成干净缓存（首次部署推荐）
- 检查
runtime/log/下是否有按日期命名的日志文件，没有说明仍不可写
验证伪静态规则是否生效
首页能打开但其他路由 404 或空白？基本是 URL 重写没配好：
- Apache：确认 .htaccess 在 public 目录下，且启用了 mod_rewrite；宝塔用户可在「伪静态」里选「ThinkPHP」模板
- Nginx：server 块中 location / { } 里必须有这行：
try_files $uri $uri/ /index.php?$query_string;，漏掉$uri/会导致带斜杠路径（如/admin/）直接 404 - 快速验证：访问
http://你的域名/index.php/test，能通说明路由正常，问题纯属重写配置
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
