Nginx 中 try_files 与 alias 混用易出错，因 alias 全量替换 URI 前缀而不保留剩余路径，导致 $uri 被错误拼接；应改用 root 或内部重写规避。
当在 Nginx 中同时使用 try_files 和 alias 时，路径解析出错是常见问题，根本原因在于 alias 的路径替换机制与 try_files 的文件查找逻辑不兼容——alias 不会像 root 那样自动拼接 URI，而 try_files 后面的路径参数（如 $uri、$uri/）是相对于请求 URI 的，不是物理路径，直接混用极易导致 404 或错误的文件被加载。
为什么 try_files + alias 容易出错
alias 的作用是将 location 匹配到的 URI 前缀**完全替换**为指定目录，且不保留原始 URI 的剩余部分；而 try_files 中的 $uri 是未经修改的原始请求 URI 路径（例如 /static/js/app.js），若 location 是 location /static/，alias /data/assets/，那么 $uri 还是 /static/js/app.js，Nginx 会尝试在 /data/assets//static/js/app.js 查找——显然错了。
正确做法：避免在 try_files 中直接用 $uri 配合 alias
解决方案不是“调参数”，而是重构逻辑。推荐以下两种稳妥方式：
-
用 root 替代 alias（最推荐）：把
alias /data/assets/;改成root /data;，并确保 location 路径与磁盘结构对齐。例如：location /static/ { root /data; try_files $uri =404; }
此时请求/static/js/app.js会映射到/data/static/js/app.js，语义清晰、行为可预测。 -
不用 try_files，改用内部重写 + alias：如果必须用 alias（比如目录名和 URL 前缀不一致），就别依赖
$uri，而是显式构造目标路径：
location /static/ { alias /data/assets/; internal; }<br>location ~ ^/static/(.+)$ { try_files /$1 @fallback; }<br>location @fallback { return 404; }
注意：需配合internal防止外部直访 alias 目录，且 rewrite 要精确匹配子路径。
调试技巧：确认实际查找路径
开启 Nginx 错误日志 debug 级别（需编译时含 --with-debug），或临时加 log_not_found on;，再结合 strace -p $(pidof nginx) -e trace=openat 观察 Nginx 真正 open 哪个文件。常见线索：
– 日志中出现 open() "/data/assets//static/xxx" failed (2: No such file) → 多余斜杠暴露了拼接错误
– stat() 调用路径明显比预期长 → 检查是否误把 $uri 当作相对路径传给了 alias 目录
一个典型错误配置与修正对比
错误写法（会导致双前缀）：location /media/ { alias /var/www/uploads/; try_files $uri =404; }
→ 请求 /media/photo.jpg 实际查找 /var/www/uploads//media/photo.jpg
正确写法（用 root）：location /media/ { root /var/www; try_files $uri =404; }
→ 请求 /media/photo.jpg 查找 /var/www/media/photo.jpg
