root末尾斜杠可选，alias末尾斜杠必须与location严格配对：root全量拼接URI（含前缀），要求磁盘存在对应子路径；alias替换location前缀，仅拼接剩余URI，不依赖磁盘层级。
末尾斜杠不是风格问题，是路径计算的开关。root 和 alias 对它的处理逻辑完全不同，错配一个斜杠，就可能拼出不存在的路径，直接 404 或返回错误文件。
root 的斜杠规则：末尾加不加都行，但建议统一加
root 指令把整个请求 URI（含 location 前缀）拼到指定目录后。Nginx 会自动补全或忽略末尾斜杠，所以 /var/www/html 和 /var/www/html/ 效果一致。
- location /admin/ { root /var/www/html; } → 请求 /admin/js/app.js 查找 /var/www/html/admin/js/app.js
- 磁盘中必须真实存在 /var/www/html/admin/ 这个子目录，否则 404
- 为避免歧义和团队协作混乱，推荐统一写成 root /var/www/html/;
alias 的斜杠规则：必须与 location 严格配对
alias 是“砍前缀 + 拼剩余路径”，斜杠位置决定是否多砍或少砍一级。它不自动修正，错一个就错全部。
- location 以 / 结尾（如 /static/），alias 值也必须以 / 结尾（如 /var/www/assets/）
- location 不带尾斜杠（如 /static），alias 值就不能带尾斜杠（如 /var/www/assets）
- 反例：location /static/ { alias /var/www/assets; } → 请求 /static/logo.png 变成 /var/www/assetslogo.png（粘连）
- 反例：location /static { alias /var/www/assets/ } → 请求 /static/ 会变成 /var/www/assets//index.html（双斜杠，多数系统 404）
怎么快速检查和避免斜杠踩坑
不用死记，用三步验证法：
- 写出完整请求 URL，比如 /api/v2/docs/index.html
- 标出 location 匹配部分（最左前缀），比如 /api/v2/，剩下就是 docs/index.html
- 把 alias 值（必须带尾斜杠）和剩下部分直接拼起来：/var/www/api-docs/docs/index.html
只要这一步拼出来的路径在磁盘上真实存在，配置就大概率正确。
实在拿不准时的替代方案
alias 逻辑强、容错低；root 逻辑直、依赖结构。如果静态资源层级和 URL 完全一致，优先用 root，省去斜杠纠结。
- 想把 /v2/ 全部指向 /var/www/docs/v2/？用 location /v2/ { root /var/www/docs; }
- 想把 /admin/ 映射到完全无关的 /opt/build/admin-dist/？只能用 alias，并严格配对斜杠
- 混用时禁止同一级 location 同时出现 root 和 alias，避免冲突和覆盖
