ThinkPHP搭建后页面打不开怎么办排查修复教程-ThinkPHP-PHP中文网

thinkphp页面打不开的根源在于环境配置、路径、权限或错误隐藏，需逐层验证：先确认php是否运行，再检查web服务器配置、开启错误显示、排查日志、确保runtime/storage可写、校验路由转发规则。

thinkphp搭建后页面打不开怎么办排查修复教程

ThinkPHP搭建后页面打不开，不是框架坏了，而是环境没对齐、路径写错了、权限卡住了，或者错误被悄悄吞掉了。直接暴露问题、逐层验证，比瞎猜快得多。

访问 http://你的域名/public/index.php，如果连这个都空白或 500，说明请求压根没进 PHP 层。用 curl 快速验证：

执行 curl -I http://localhost/public/index.php，看响应头里有没有 X-Powered-By: ThinkPHP
没有？那问题在 Web 服务器配置：Apache 要确认 .htaccess 存在且 AllowOverride All 开启；Nginx 必须在 location / 块里配 try_files $uri $uri/ /index.php?$query_string;
注意：Nginx 的 root 必须指向项目 public 目录，比如 root /www/wwwroot/myapp/public;，写成项目根目录会直接导致 Class 'think\App' not found

ThinkPHP 在生产环境默认不显示错误，白屏是“静默失败”，不是没错误。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 public/index.php 第一行 PHP 标签后立刻加两行：
```
ini_set('display_errors', '1');<br>error_reporting(E_ALL);
```
（仅调试用，上线前务必删掉）
如果仍没报错，去查日志：运行 php -i | grep error_log 找到 PHP 错误日志路径，再用 tail -f /var/log/php_errors.log 刷新页面实时观察
同时检查 ThinkPHP 自己的日志：runtime/log/ 下当天的 log 文件，常有更具体的上下文

ThinkPHP 启动时要在 runtime/ 下建子目录、写缓存和日志。如果 Web 进程用户（如 www-data、nginx）没权限，就会 500 白屏，还不留痕迹。

确保 runtime 目录存在，且属主和权限正确：
chmod -R 755 runtime
chown -R www-data:www-data runtime
TP6+ 还依赖 storage/ 目录，同样要可写
删掉整个 runtime/ 目录再试一次，避免旧缓存干扰

首页能打开，其他路由空白或 404，基本锁定在路由转发环节。

Nginx 用户：别用 if (!-e $request_filename) 这种老旧写法，它在 Windows 或某些 PHP 版本下会让 $_SERVER['PATH_INFO'] 为空，TP8 默认靠它解析路由，一空就失效
Apache 用户：确认伪静态已启用，宝塔里选“ThinkPHP”模板，不是 Laravel 或其它
绕过重写测试：直接访问 http://域名/index.php/控制器/方法，能通说明路由本身没问题，问题纯属 Web 服务器转发配置