用 alias 而非 root 映射子路径，因 root 全量拼接 uri 导致多层路径 404，alias 则替换前缀精准定位；alias 路径必须以 / 结尾且不可用于正则 location。
用 root 还是 alias，直接决定静态资源 404 还是秒开——不是配置写错了，是路径拼出来根本就不存在。
root 是 URI 全量追加，不是“设个根目录”那么简单
root 的行为非常机械：它把整个请求 URI（包括 location 匹配到的前缀）原封不动拼在指定路径后面。
比如这个配置：
location /app/ {
root /data/project/dist;
index index.html;
}
当请求 /app/ 时，Nginx 实际查找的是：/data/project/dist/app/index.html。但你的真实文件在 /data/project/dist/index.html，中间多了一层 /app/，必 404。
-
root路径末尾加不加/都行（/data/和/data效果一致） - 它适用于 URI 结构和磁盘目录结构完全对齐的场景，比如
location /指向站点根目录 - 搭配
index时，只在最终拼出的路径是目录时才生效；若拼出的是文件（如/app/favicon.ico），index不起作用
alias 是前缀替换，必须带尾部斜杠且不能用于正则 location
alias 的核心动作是“砍掉匹配到的 URI 前缀，再把剩余部分接在 alias 路径后”。所以它天然适合做虚拟目录映射。
正确写法：
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
location /app/ {
alias /data/project/dist/;
index index.html;
}
请求 /app/ → 去掉 /app/，剩下空字符串，拼上 /data/project/dist/ → 查找 /data/project/dist/index.html，命中。
-
alias后的路径**必须以/结尾**（/data/project/dist/✅，/data/project/dist❌），否则 Nginx 会把 URI 剩余部分错误粘连（例如/app/test.js变成/data/project/disttest.js） -
alias**不能用在正则location ~中**，除非你手动捕获并显式拼接（如alias /var/data/$1;），但风险高、可读性差，不推荐 - 它不支持
try_files的 fallback 行为——try_files内部仍按root规则解析路径，和alias冲突
PHP-FPM 场景下，root/alias 对 fastcgi_param SCRIPT_FILENAME 的影响
前后端分离或 PHP 应用挂子路径时，SCRIPT_FILENAME 的值必须指向真实 PHP 文件，否则 502 或 404。
如果你用 alias 映射 /api/ 到 /var/www/api/，又想跑 PHP：
location ~ ^/api/(.+\.php)$ {
alias /var/www/api/;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
# 必须重写 SCRIPT_FILENAME，否则它会按 root 规则拼：
fastcgi_param SCRIPT_FILENAME /var/www/api/$1;
}
- 默认的
fastcgi_params里SCRIPT_FILENAME是基于document_root+script_name拼的，而document_root在alias下不会自动更新 - 用
root则无需手动干预，只要目录结构一致，SCRIPT_FILENAME自然正确 - Nginx 1.22.1 + PHP 8.0.30 组合下，这个参数错一个字符就会导致空白页或 “No input file specified” 错误
排错时别只看配置，要看 nginx -T 和 error.log 里的 open() 调用
你写的配置和 Nginx 实际执行的，可能不是一回事——特别是用了 include、多层 location 嵌套或默认继承时。
- 运行
nginx -T输出**最终合并后的完整配置**，确认你改的location真的生效、没被更高优先级规则覆盖 - 打开
error.log，搜索open()关键字，它会明确打印 Nginx 尝试打开的**绝对路径**，比如：open() "/data/project/dist/app/index.html" failed (2: No such file or directory)—— 这就是最硬的证据 - 权限、SELinux、软链断裂也会导致 open 失败，但日志里报的路径如果本身就错了，优先查
root/alias逻辑
真正卡住人的，往往不是不会写，而是没意识到 Nginx 拼路径时根本不“理解”你的业务意图——它只认规则。多推演一次请求 URI 到文件路径的转换过程，比 reload 十次都管用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
