ThinkPHP与Nginx配合下的伪静态丢失_location匹配配置技巧-ThinkPHP-PHP中文网

thinkphp路由失效的根本原因是nginx未将非静态请求转发至index.php；必须配置location /块配合try_files $uri $uri/ /index.php?s=$uri&$args，确保所有非真实文件请求兜底重写，且location ~ .php$须保留并置于location /之前。

thinkphp与nginx配合下的伪静态丢失_location匹配配置技巧

ThinkPHP 路由失效，Nginx 返回 404 的根本原因

不是 ThinkPHP 配置错了，是 Nginx 根本没把请求交给 index.php 处理——location 块没兜住除静态资源外的所有请求。

ThinkPHP 的伪静态依赖 Nginx 把所有非真实文件/目录的请求，全部重写到 index.php 入口。如果 location ~ \.php$ 只匹配带 .php 后缀的 URL，那像 /user/list 这种路由就直接 404 了。

常见错误现象：GET /admin/dashboard 返回 404，但 GET /index.php/admin/dashboard 正常
典型误配：location ~ \.php$ 单独存在，没配更宽泛的 try_files 或 rewrite 规则
关键点：ThinkPHP 的「伪静态」本质是 URL 重写，Nginx 层必须主动做转发，不能指望 PHP 自己“解析路径”

Nginx 必须写的 `location /` 块（不是可选）

ThinkPHP 要跑起来，location / 是绕不开的入口守门员。它负责判断请求是否对应真实文件，不是就甩给 index.php。

别用 rewrite ^(.*)$ /index.php?s= last; 这类老写法，容易循环或漏掉 query string；现代推荐用 try_files + fastcgi_param 组合。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

标准写法（放在 server 块内）：

location / {
    try_files $uri $uri/ /index.php?s=$uri&$args;
}

$uri 匹配静态文件（如 /static/css/app.css），$uri/ 匹配目录，最后兜底到 /index.php?s=...
注意 &$args —— 没它，带参数的 URL（如 /user?id=123）里 $_GET 会为空
如果项目部署在子目录（如 https://example.com/shop/），/index.php 要改成 /shop/index.php，且 s=$uri 改为 s=$request_uri 更稳妥

为什么 `location ~ \.php$` 不能删、也不能乱改

这个块不处理路由，只负责把 PHP 脚本交给 PHP-FPM 执行。但它和上面的 location / 是协作关系——前者只响应以 .php 结尾的请求，后者兜底其他所有请求并重写为 /index.php?...，再触发前者执行。

必须保留 location ~ \.php$，否则 /index.php 本身都打不开
常见坑：location ~ \.php$ 写在 location / 之后，导致优先级错乱（Nginx 按顺序匹配，最长前缀优先，但正则优先级高于普通 location）
安全建议：加 fastcgi_intercept_errors on;，避免 PHP 错误信息直接暴露
务必确认 fastcgi_param SCRIPT_FILENAME 指向的是真实磁盘路径，例如：
```
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
```
而不是硬编码路径

调试时先看 Nginx error log，不是 ThinkPHP 日志

路由 404 时，90% 是 Nginx 没转发成功，PHP 根本没收到请求。这时候翻 ThinkPHP 的 runtime/log 是白忙活。

查日志命令：tail -f /var/log/nginx/error.log
典型线索：open() "/var/www/html/user/list" failed (2: No such file or directory) → 说明 Nginx 尝试找物理文件，没走 try_files 兜底
另一个线索：FastCGI sent in stderr: "Primary script unknown" → SCRIPT_FILENAME 路径拼错了，PHP-FPM 找不到 index.php
临时验证：在 location / 里加 return 200 "hit location /";，访问任意路径看是否返回，能快速定位是否进对了 block