ThinkPHP Nginx 404 根本原因是请求未转发至 index.php：默认配置下 Nginx 直接查找静态文件，失败即返回 404，未进入框架路由；需通过 try_files 或 rewrite 将非静态请求重写到 index.php，并确保 SCRIPT_FILENAME 指向正确物理路径。
如果您已将ThinkPHP项目部署至Nginx服务器，但访问时仍需携带index.php（如https://example.com/index.php/index/hello），或出现404错误，则说明URL重写未生效。根本原因在于Nginx未将非静态请求转发至public/index.php入口文件，导致框架路由机制无法启动。以下是适配ThinkPHP各版本的多种Nginx重写配置方案：
一、标准try_files方案（推荐用于ThinkPHP 6.x）
该方案利用try_files指令实现原子化路径匹配，避免rewrite循环，兼容QUERY_STRING传递，是TP6官方推荐方式。它优先尝试匹配真实静态资源，失败后统一交由index.php处理，并保留原始查询参数。
1、编辑站点server块，在location /内添加以下规则：
2、try_files $uri $uri/ /index.php?$query_string;
立即学习“PHP免费学习笔记（深入）”；
3、确保location ~ \.php$块中fastcgi_param SCRIPT_FILENAME值为$document_root$fastcgi_script_name，严禁使用$request_filename。
4、确认PHP-FPM监听地址与fastcgi_pass配置一致（如unix:/var/run/php/php8.1-fpm.sock或127.0.0.1:9000）。
二、PATH_INFO兼容方案（适用于ThinkPHP 5.1及启用pathinfo模式的场景）
当应用配置了'url_model' => 2（PATH_INFO模式）或需兼容旧路由格式（如/index.php/Index/index）时，必须显式提取并传递PATH_INFO变量，否则$_SERVER['PATH_INFO']为空，路由解析失败。
1、在location /块中使用if判断+rewrite组合：
2、if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }
3、在location ~ \.php$块中添加PATH_INFO支持指令：
4、fastcgi_split_path_info ^(.+\.php)(/.+)$;
5、fastcgi_param PATH_INFO $fastcgi_path_info;
6、必须同时设置fastcgi_param SCRIPT_NAME $fastcgi_script_name，否则$_SERVER['SCRIPT_NAME']异常影响URL生成。
三、子目录部署适配方案（如部署在https://example.com/app/下）
当ThinkPHP未部署在域名根路径，而是位于子目录（如/app/）时，Nginx需识别前缀并剥离后将剩余URI传递给框架，否则Route::rule()无法匹配定义的路由规则。
1、定义带前缀的location块：location /app/ {
2、在该块内使用try_files并指定入口相对路径：try_files $uri $uri/ /app/index.php?$query_string;
3、修改root指令指向网站根目录（非子目录），例如root /var/www/html;，确保$document_root/app/index.php可被定位。
4、所有rewrite目标路径必须以/app/开头，且正则捕获组需排除前缀，例如rewrite ^/app/(.*)$ /app/index.php?s=/$1 last;。
四、安全增强型配置组合（禁用敏感路径+隐藏文件）
除重写功能外，必须同步限制对框架敏感目录的Web直接访问，防止.env、runtime、config等目录泄露，这是生产环境强制要求。
1、在server块中添加独立location规则屏蔽敏感目录：
2、location ~ ^/(app|config|database|runtime|vendor|extend)/ { deny all; }
3、添加隐藏文件禁止访问规则：
4、location ~ /\. { deny all; }
5、特别注意：.env文件必须被deny，否则数据库密码等关键信息将完全暴露。
五、调试与验证步骤
配置修改后需逐项验证是否生效，避免因语法错误或缓存导致误判。Nginx配置变更必须重载而非仅重启，且需确认PHP-FPM服务处于运行状态。
1、执行nginx -t检查配置语法是否正确，输出'syntax is ok'且'test is successful'才可继续。
2、执行nginx -s reload平滑重载配置，不中断现有连接。
3、创建测试路由（如route/app.php中添加Route::get('test-rewrite', function(){ return 'success'; });）。
4、访问https://example.com/test-rewrite，若返回'success'且URL中无index.php，则重写成功；若返回404，检查error.log中是否有FastCGI sent in stderr: "Primary script unknown"类错误。
