Nginx Alias 与 try_files 怎么配合使用-Nginx-PHP中文网

nginx 中 alias 与 try_files 混用易致 404，因 alias 不改变 $uri 而 try_files 默认用 $uri 查找文件；正确方式为：①优先用 root 替代 alias，②非用 alias 时必须用 $request_filename。

nginx alias 与 try_files 怎么配合使用

Nginx 中 alias 和 try_files 直接混用容易出 404，不是配置写错了，而是两者路径处理机制天然不兼容。

alias 是做 URI 前缀截断 + 路径拼接，但它不改变 $uri 的值；而 try_files 默认用 $uri（原始请求路径）去 root 下找文件，完全不知道 alias 已经把实际路径换掉了。结果就是：文件明明在 /var/www/assets/js/app.js，Nginx 却去 /var/www/html/static/js/app.js 查——自然 404。

✅ 正确配合方式只有两种，选其一

优先用 root 替代 alias（推荐）
语义清晰、行为可预测，尤其适合静态资源前缀映射：

location /static/ {
    root /var/www;
    try_files $uri $uri/ =404;
}

请求 /static/js/app.js → 拼成 /var/www/static/js/app.js，直接检查是否存在，无需额外绕弯。

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

非用 alias 不可时，必须用 $request_filename
它是 Nginx 内部已根据 alias 计算出的真实绝对路径，try_files 才能真正校验目标文件：

location /assets/ {
    alias /opt/app/dist/assets/;
    try_files $request_filename $request_filename/ =404;
}

$request_filename 此时已是 /opt/app/dist/assets/js/app.js，检查它是否存在才有效。

⚠️ 常见错误写法（务必避免）

try_files $uri =404; —— $uri 还是 /assets/js/app.js，Nginx 仍按 root 拼，错位
try_files /$uri =404; —— 手动加 / 反而变成 /assets/js/app.js，路径更乱
在正则 location 里混用 alias 和 try_files 且未显式引用捕获变量 —— 容易触发 internal redirection cycle

? 实际场景示例：SPA + 静态资源分离

location /assets/ {
    alias /opt/app/dist/assets/;
    try_files $request_filename =404;
}

location / {
    root /opt/app/dist;
    try_files $uri $uri/ /index.html;
}