ThinkPHP 8.1 伪静态生效需服务器配置、框架设置、目录结构三者严格对齐：Nginx 规则须置于 location / 块内且在 PHP 块之前，用 try_files $uri $uri/ /index.php?$query_string；PHP 块中必须包含 SCRIPT_FILENAME、PATH_INFO、PATH_TRANSLATED 三项参数；框架内 url_route_on=true、pathinfo_depr='/'、url_html_suffix=''；root 必须指向 public 目录，runtime 可写且禁用 open_basedir。
ThinkPHP 8.1 开启伪静态不是改一个地方就能生效，必须服务器配置、框架设置、目录结构三者严格对齐。漏掉任意一环，轻则 URL 带 index.php，重则白屏或 404。
一、Nginx 配置要到位
规则必须写在 server 块的 location / { } 内，且要在 location ~ \.php$ 之前（Nginx 按顺序匹配）：
-
推荐用
try_files（更稳）：确保root指向public目录，例如root /www/wwwroot/myapp/public;，再加一行：try_files $uri $uri/ /index.php?$query_string; - 别用
if (!-e $request_filename)，尤其在 Windows 下的 phpStudy 中容易清空PATH_INFO，导致 TP8 静默白屏 - 子目录部署（如
/myapp/）必须单独写location /myapp/ { }块，不能塞进根location /里做 rewrite
二、PHP 处理块不能少关键参数
在 location ~ \.php$ 块中，必须包含以下三项（缺一不可）：
-
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;（注意是$document_root，不是$request_filename） fastcgi_param PATH_INFO $fastcgi_path_info;fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
否则 TP8 无法正确解析路由路径，所有带参数的请求都会 fallback 到默认控制器。
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
三、框架内配置必须启用并匹配
打开 config/app.php，确认以下项已设为：
-
'url_route_on' => true,（路由开关，必须开） -
'pathinfo_depr' => '/',（分隔符必须是斜杠，和 Nginx 的s=或$query_string解析逻辑一致） -
'url_html_suffix' => '',或按需设为'.html'；若设非空值（如'html'），又没对应真实文件，会导致 404
多应用模式下，还要检查 domain_bind 是否与访问域名完全一致（含 www、端口）。
四、目录与权限基础要扎实
这是常被忽略但直接决定成败的前提：
- 网站根目录（Nginx 的
root）必须指向项目的public子目录，不是项目根目录 -
runtime目录需可写（chown -R www:www runtime/），否则日志、缓存全失效 - 宝塔用户请务必关闭【防跨站攻击（open_basedir）】，否则
runtime写入失败，错误日志只显示“Permission denied”
