Win11搭建ThinkPHP 8.0：解决Nginx伪静态配置导致的页面空白【教程】-ThinkPHP-PHP中文网

thinkphp 8.0在windows 11下nginx白屏主因是root未指向public目录、误用if+rewrite导致path_info为空、script_filename路径错误或url_route_on关闭；需修正root路径、改用try_files、补全fastcgi_param三行并启用路由。

win11搭建thinkphp 8.0：解决nginx伪静态配置导致的页面空白【教程】

在Windows 11上用phpStudy或手动配置Nginx运行ThinkPHP 8.0时，明明伪静态规则已写入、Nginx也重载成功，但访问除首页外的所有路由（如/index/user）却只显示一片空白，控制台报vendor.js failed to load或网络面板显示200 OK但响应体为空——这不是前端问题，是Nginx转发后PHP未正确加载框架入口或运行时目录错位导致的致命中断。

确认是否真为Nginx转发引发的白屏

先排除框架自身崩溃：直接在浏览器访问http://localhost/index.php/index/user，如果能正常显示内容，说明ThinkPHP本身可运行；若仍空白，则问题在PHP环境或runtime权限；若能通，但http://localhost/index/user空白，就锁定为Nginx未正确传递请求上下文。

打开Nginx错误日志（phpStudy中为c:\phpstudy_pro\extensions\nginx1.22.1\logs\error.log），搜索FastCGI sent in stderr或Primary script unknown——出现前者说明PHP执行了但中途退出；出现后者说明Nginx根本没找到index.php文件路径。

检查并修正Nginx的root与location匹配逻辑

ThinkPHP 8.0强制要求Web服务器的DocumentRoot指向项目public/目录，而非项目根目录。若root设为D:/www/myapp，则vendor/autoload.php会因相对路径错误无法加载，直接触发Fatal error: Class 'think\App' not found且不报错，页面即空白。

进入Nginx站点配置文件（如c:\phpstudy_pro\extensions\nginx1.22.1\conf\vhosts.conf），定位对应server块，将root指令明确指向public子目录：

【root D:/www/myapp/public;】

注意：不能写成root D:/www/myapp;，也不能漏掉末尾分号。写错会导致$document_root解析为错误路径，后续所有fastcgi_param SCRIPT_FILENAME拼接都失效。

替换老旧if+rewrite写法，启用标准try_files规则

很多教程仍沿用if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }，该写法在Windows下极易因路径分隔符和大小写敏感性导致$_SERVER['PATH_INFO']为空，ThinkPHP 8.0默认依赖PATH_INFO解析路由，一空就静默失败、页面空白。

方法一：直接删除整个if块，在location / { }内写入标准规则

location / {
try_files $uri $uri/ /index.php?$query_string;
}

方法二：若部署在二级目录（如http://localhost/myapp/），必须同步调整location和fallback路径

location /myapp/ {
try_files $uri $uri/ /myapp/index.php?$query_string;
}

btpanel phpsite 宝塔面板PHP网站

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

下载

删掉所有含rewrite和if的行——Nginx官方明确不推荐在location中使用if，Windows下尤其不稳定。

补全PHP-FPM处理块中的关键参数

仅配好location还不够。Nginx需把请求准确“交棒”给PHP-FPM，缺一不可：

第一步：确认PHP处理块存在且被正确include。在vhosts.conf中找location ~ \.php$段落，确保它位于location /内部或同级，不能孤立在外。

第二步：在该location块内，必须包含以下三行（顺序无关，但缺一不可）：

fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;

特别注意：【必须用$realpath_root而非$document_root】——Windows下符号链接不常见，但$realpath_root能规避路径解析歧义，防止PHP-FPM去执行D:/www/myapp/public//index.php这类双斜杠路径而报错。

第三步：检查该块是否已启用include fastcgi.conf;或include fastcgi_params;。若已包含，确认fastcgi.conf里没有覆盖上述三行；若有冲突，优先以显式写的三行为准。