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; }
