Windows下Nginx 1.31.6搭配PHP 8.1.30出现404，主因是Nginx未正确路由请求至index.php，需重点核查三方面：root是否指向public目录、PHP处理块（含fastcgi_pass和SCRIPT_FILENAME）是否完整启用、URL重写（try_files $uri $uri/ /index.php?$query_string）是否生效。
Windows 下 Nginx 1.31.6 搭配 PHP 8.1.30 出现 404，通常不是 PHP 本身的问题，而是 Nginx 未能把请求正确路由到 index.php 或找不到对应文件。重点查三件事：路径是否对、PHP 是否真在执行、重写是否生效。
确认 Nginx root 路径指向 public 目录
现代 PHP 框架（如 Laravel、Lumen）要求 Web 根目录是项目内的 public/ 子目录，不是整个项目根目录。例如：
- 你的项目解压在 D:\myapp，那实际入口是 D:\myapp\public\index.php
- Nginx 配置中 root 必须设为 D:\myapp\public（注意末尾不加斜杠）
- 如果错设成 D:\myapp，访问
/会找D:\myapp\index.php—— 文件不存在，直接 404
检查 PHP 处理块是否完整启用
Nginx 不会自动执行 .php 文件，必须显式配置 location ~ \.php$ 块，并确保它真正生效。常见漏项：
- 没写 fastcgi_pass：必须指定 PHP-FPM 的监听地址，例如
fastcgi_pass 127.0.0.1:9000;或fastcgi_pass unix:/path/to/php-fpm.sock;（Windows 不支持 Unix socket，用 TCP） - 漏掉 SCRIPT_FILENAME 参数：加上这行才能让 PHP 知道执行哪个文件：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; - 没包含 fastcgi_params：建议写全
include fastcgi_params;，避免参数缺失 - PHP-FPM 服务未运行：打开命令行，执行
php-cgi -v看 PHP 版本；再确认php8.1-fpm.exe（或类似名称）是否已启动（Windows 下常用 Windows 服务或手动运行）
验证 URL 重写是否生效（尤其前端路由或子路径）
访问 /login、/api/users 等非根路径返回 404？说明重写没起作用。Nginx 需把所有非静态资源请求都转给 index.php。在 location / 块里加：
立即学习“PHP免费学习笔记（深入）”；
try_files $uri $uri/ /index.php?$query_string;- 别写成
try_files $uri =404;—— 这会让所有不存在的 URI 直接 404，跳过 PHP - 测试方法：在
public\index.php开头加<?php die('routed'); ?>，然后访问http://localhost/test。如果输出 routed，说明重写成功；否则仍是空白或 404，问题还在 Nginx 配置
快速验证与收尾动作
改完配置后务必执行：
- 进入 Nginx 安装目录（如 D:\nginx-1.31.6），运行
nginx -t检查语法是否正确 - 执行
nginx -s reload重载配置（若失败，先nginx -s stop再start nginx） - 查看 logs\error.log —— Windows 下日志默认在 Nginx 安装目录的 logs 子目录，错误信息往往比页面提示更直接
- 浏览器访问时按
Ctrl+Shift+R强制刷新，排除缓存干扰
