说实话，绝大多数ThinkPHP搭建完打不开，还真不是代码写错了——问题往往卡在请求根本没进入框架。环境不对、配置没到位，这才是90%的故障根源，跟路由、控制器关系不大。 先从最基础的开始排查：PHP环境是否达标，扩展是不是齐全的。 用终端敲一下`php -v`看看版本。TP8得是8.1以上，TP6至少是7.2.5。再跑一下`php -m | grep -E 'mbstring|openssl|pdo|curl|intl'`，这五个扩展缺一个，你的`public/index.php`轻则白屏，重则直接报500错误，而且不会给你任何提示。 这里有几个非常容易踩的坑：Windows用户如果用的XAMPP自带的旧版PHP，PDO扩展大概率默认就是禁用的。Mac用户用Homebrew安装PHP时，openssl扩展经常被漏掉。至于宝塔用户，操作起来倒简单——进「软件商店 → PHP → 设置 → 安装扩展」，手动把缺失的扩展勾上就行。 环境没问题了，接着看网站根目录和运行目录的设置。 ThinkPHP 6+版本强制要求入口统一收敛到`/public`子目录，这个设定在宝塔上特别容易翻车。操作路径是：进「网站 → 设置 → 网站目录」，找到「运行目录」，必须下拉选择`/public`——别手动输入，下拉框选完以后，点「保存」，再顺手点一下「重启站点」，否则改动不会生效。 还有一个安全层面的提醒：千万别把整个项目根目录直接设为网站根目录，也就是`app/`、`vendor/`、`public/`这些文件夹都暴露在外。那样一来，框架的核心文件就全裸奔了，风险极高。 做好这些，我们还得验证一下PHP是不是真的接收到了请求。 直接访问`https://你的域名/public/index.php`，如果还是白屏或500，可以用`curl -I https://你的域名/public/index.php`查一下响应头。如果看到`X-Powered-By: ThinkPHP`，说明PHP已经跑起来了；如果只有`Server: nginx/Apache`，那说明Web服务器根本没把请求转给PHP。 Apache用户要确认`public/.htaccess`文件存在，并且虚拟主机配置里`AllowOverride All`已经开启。Nginx用户则需要检查`server`块是否包含了`try_files $uri $uri/ /index.php?$query_string;`——这条规则里的`$query_string`很容易被漏掉，一旦漏掉，GET参数会全部丢失，后面的路由匹配也就全废了。 最后，用一个小技巧快速判断是重写规则问题，还是路由本身没加载。 绕过伪静态，直接测试入口是否通：访问`https://你的域名/index.php/index/index`，这是TP6/TP8的默认首页路由。如果能打开，说明框架本身没问题，是服务器重写规则没配好。如果打不开，那就需要跑一下`php think route:list`，看看输出里有没有目标路由。如果输出为空或者报错，说明`route/route.php`文件没被加载，或者文件里只写了注释和`return []`。同时检查一下`config/app.php`，确认`'url_route_on' => true`已经开启，并且`'app_debug' => true`也设为true，这样能看到详细的错误提示，排查起来会省力很多。