root指令仅指定静态文件根目录，不处理FastCGI；FastCGI通过$document_root拼接SCRIPT_FILENAME路径，root必须与$document_root一致且末尾不加斜杠，避免路径错误导致404或“No input file specified”。
root 指令本身不运行 FastCGI，它只负责告诉 Nginx “静态文件放在哪”，而 FastCGI 处理的是动态请求（比如 .php 文件）。两者配合的关键，在于让 PHP 脚本的路径计算结果准确指向真实文件位置，否则 fastcgi_param SCRIPT_FILENAME 会传错路径，导致 404 或 No input file specified 错误。
root 必须与 $document_root 保持一致
FastCGI 配置中常写：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
这里的 $document_root 就是当前 location 块中 root 指令指定的值。Nginx 用它拼出 PHP 文件的绝对路径，再交给 php-fpm 执行。
- 如果 location ~ \.php$ { root /var/www/site; }，那么访问 /index.php 时，$document_root 就是 /var/www/site，最终 SCRIPT_FILENAME 是 /var/www/site/index.php
- root 值末尾不能加斜杠（如 /var/www/site/），否则可能拼出双斜杠，部分系统下触发权限或路径解析异常
- root 写在 location 块内才生效；若没写，Nginx 会回退到 server 或 http 级的 root，容易和预期不符
别把 root 和 alias 混用在同一 location 中
alias 会替换整个 URI 路径，而 root 是拼接。两者逻辑冲突，混用极易出错：
- 错误写法：
location /app { alias /project/app/; root /var/www/; }—— root 在这里无效，且语义矛盾 - 正确做法：要么用 root + $document_root（推荐，语义清晰），要么用 alias + $request_filename（需同步改 SCRIPT_FILENAME）
- 用 alias 时，SCRIPT_FILENAME 应设为
$request_filename，因为 alias 已完成路径映射，不需要再拼
常见路径错位问题及修复
典型报错 “No input file specified” 很多时候就是 root 设错，导致 SCRIPT_FILENAME 指向了不存在的路径。
- 检查 PHP 文件实际存放位置，比如 /var/www/myapp/index.php
- 确认对应 location 的 root 是否设为 /var/www/myapp（不是 /var/www 或 /var/www/myapp/）
- 验证 $fastcgi_script_name 值：访问 /admin/user.php 时，它应为 /admin/user.php，不是 /user.php（除非用了 rewrite）
- 临时加日志调试：在 location 块中加
error_log /var/log/nginx/debug.log notice;，并在 fastcgi_param 后加fastcgi_param DEBUG_PATH "$document_root$fastcgi_script_name";，然后看日志里拼出的路径对不对
配合 try_files 实现优雅降级
现代 PHP 应用（如 Laravel、WordPress）常依赖前端控制器模式，需要把非静态资源请求统一交由 index.php 处理。这时 root 仍指明文档根目录，但路由交由 PHP 控制：
root /var/www/laravel;location / { try_files $uri $uri/ /index.php?$query_string; }location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/run/php/php8.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; }- 这样既保证静态资源（CSS/JS/图片）由 root 直接服务，又让所有 PHP 请求都落到正确的入口文件上
