root指令将完整URI路径追加到指定根目录后，如location /static/ { root /var/www; }请求/static/css/app.css时查找/var/www/static/css/app.css。
在 Nginx 中，root 指令决定静态文件的根目录，但它**不直接拼接 URI 路径**，而是将请求的 URI（包括前缀）整体追加到 root 指定的路径末尾。理解这一点是避免 404 的关键。
root 指令的真实行为：URI 全量拼接
Nginx 不会“截掉 location 匹配前缀再拼接”，而是把整个请求 URI（从第一个 / 开始）作为后缀，加到 root 路径后面。
- 配置示例：
location /static/ {
root /var/www;
} - 请求 /static/css/app.css → 实际查找路径为：
/var/www/static/css/app.css（注意：/static/ 出现在 root 后面） - 也就是说，root 后的路径 + 完整 URI = 最终文件系统路径
对比 alias：alias 才会“替换匹配前缀”
如果希望 /static/ 对应到 /var/www/assets/ 目录下，且不保留 /static/ 前缀，应该用 alias：
- 配置：
location /static/ {
alias /var/www/assets/;
} - 请求 /static/css/app.css → 查找：/var/www/assets/css/app.css
- 注意 alias 值末尾的 / 很重要：它表示“替换整个匹配部分”，缺了会导致路径错位
常见错误与排查技巧
- 404 却确认文件存在？检查 Nginx 日志（error.log），看它实际尝试访问的路径是什么
- 误把 root 当作“映射前缀”用：比如写
location /img { root /data; }，请求 /img/logo.png 会找/data/img/logo.png，而非/data/logo.png - root 路径末尾不加 / 也能工作，但建议统一加，避免和 alias 混淆；Nginx 会自动处理路径分隔符
- root 可在 http、server、location 级别定义，子级会覆盖父级；优先级：location > server > http
实用建议：什么时候用 root，什么时候用 alias？
- 用 root：站点主目录（如
location / { root /var/www/html; }），或 URI 路径天然对应磁盘结构 - 用 alias：需要把某个 URI 前缀“映射到完全不同的目录”，且不想在文件路径中体现该前缀（如 CDN 静态资源代理、前端路由 fallback）
- 简单口诀：
root = “我在哪？然后按原样找”
alias = “我替换成哪？再按剩下的找”
