root是拼接路径，alias是替换路径：root将完整URI追加到指定目录后（如/static/css.css→/var/www/static/css.css），要求文件系统存在对应子目录；alias则抹去location前缀再拼接（如/api-docs/index.html→/usr/share/nginx/html/swagger/index.html），且alias路径必须以/结尾。

root 和 alias 看似都能把 URL 映射到文件系统，但它们的路径处理逻辑截然不同——用错一个符号，静态资源就 404；配错一处斜杠，SPA 路由直接崩掉。核心就一句话：root 是拼接，alias 是替换。

root：在指定目录下“追加”完整请求路径

root 把 location 块匹配到的整个 URI（包括前缀）原样拼到所设路径后面。

• 配置：location /static/ { root /var/www; }
• 请求：/static/css/main.css
• 真实查找路径：/var/www/static/css/main.css（注意：多了 /static/ 这一级）

这意味着：root 要求文件系统中必须存在与 location 路径同名的子目录。适合部署结构天然对齐的站点，比如把整个前端项目放在 /var/www/myapp/，再用 location /myapp/ { root /var/www; } 访问。

alias：把 location 前缀“完全去掉”，只拼剩余部分

alias 不保留 location 中已匹配的部分，它把那段前缀视为“虚拟路径”，直接抹掉，再把剩下的 URI 拼到 alias 路径后。

• 配置：location /api-docs/ { alias /usr/share/nginx/html/swagger/; }
• 请求：/api-docs/index.html
• 真实查找路径：/usr/share/nginx/html/swagger/index.html（没有 /api-docs/）

关键约束：alias 后的路径必须以 / 结尾（除非明确指向单个文件），且 location 也建议以 / 结尾，否则可能因路径截断引发 403 或 404。

为什么 alias 更适合 SPA 和静态资源别名？

单页应用（如 Vue、React）通常只有一个 index.html，所有路由由前端接管。若用 root 配置 location /app/ { root /opt/dist; }，访问 /app/sub/page 会去找 /opt/dist/app/sub/page —— 不存在，返回 404。

而 alias 可精准映射：

• location /app/ { alias /opt/dist/; } → /app/any/route 查找 /opt/dist/any/route
• 配合 try_files 实现 fallback：try_files $uri $uri/ /app/index.html;，让所有子路径都回退到 SPA 入口

常见踩坑点和检查清单

• alias 写成 alias /opt/dist（缺末尾 /）→ Nginx 把它当文件处理，导致 404 或 403
• location 写成 location /static（无结尾 /）→ 正则或前缀匹配可能不严谨，/static123 也被误匹配，造成路径错乱
• 在同一个 location 中同时写 root 和 alias → alias 优先生效，root 被静默忽略，容易埋下配置盲区
• 用正则 location 配 alias 时，必须用捕获组 + $1 引用，例如：location ~ ^/v(\d+)/static/(.+)$ { alias /opt/api/v$1/static/$2; }