root是“拼路径”，alias是“换前缀”；root将完整uri拼接到指定目录后，如location /static/ { root /var/www; }访问/static/css/app.css时查找/var/www/static/css/app.css，而非/var/www/assets/下的文件。
别硬记概念，先看结果：root 是“拼路径”，alias 是“换前缀”。用错一个，404、错文件、甚至泄露 /etc/passwd 都可能发生。核心不是语法对不对，而是你心里有没有那条“请求路径 → 实际磁盘路径”的映射链。
搞清 root 的真实行为：它不删前缀，只加后缀
很多人以为 location /static/ { root /var/www; } 表示“把 /static/ 映射到 /var/www”，其实不是。Nginx 会把整个请求 URI（包括 /static/）拼上去：
- 请求
/static/css/app.css→ 查找/var/www/static/css/app.css - 所以
/var/www目录下必须真有static/子目录 - 如果静态资源实际放在
/var/www/assets/，却写成root /var/www/assets;，那请求/static/xxx就会去找/var/www/assets/static/xxx—— 不存在，直接 404
用 alias 前必须确认三件事
alias 不是 root 的“友好替代版”，它是另一套逻辑。启用前检查：
-
location 必须以
/结尾（如/static/），否则匹配可能不精确或漏掉斜杠 -
alias 值末尾必须带
/（如alias /opt/assets/;），否则/static/logo.png可能变成/opt/assetslogo.png -
不能和
try_files同时用在一个 location 里 —— try_files 会忽略 alias，按 root 规则找文件，导致行为不可控
哪些场景坚决不能混用或误替
有些配置看着差不多，换指令就翻车：
- 正则 location（如
location ~ \.js$）中用 alias：老版本 Nginx 直接报错；新版本虽支持，但捕获变量拼接易出错，建议改用rewrite + break配合 root - 想把
/api/指向后端服务根目录，却写root /opt/backend;：Nginx 会去找/opt/backend/api/xxx，而不是/opt/backend/xxx—— 这时该用alias /opt/backend/; - 在
server块里写了root，又在某个location里没写root或alias：Nginx 会回退到 server 级的 root，但路径拼接逻辑仍按 location 匹配部分执行，容易偏离预期
排查时盯住这一行日志
打开 debug 日志：error_log /var/log/nginx/error.log debug;，然后发一次请求。Nginx 会在日志里明确写出它“实际尝试打开的文件路径”，比如：
把这个路径和你的磁盘结构一比，就知道是 root 拼多了、alias 少了斜杠，还是权限/SELinux 挡住了。
