try_files 是 Nginx 静态资源兜底核心指令，按参数从左到右匹配存在文件或目录，全失败则重定向至最后一个参数；常用于图片缺失时返回占位图或交由动态服务处理，需注意 alias/root 路径拼接与 $uri 含义。
Try_files 是 Nginx 处理静态资源“兜底”的核心指令，尤其适合图片缺失时自动降级到默认图、占位图或动态生成图，避免 404 或后端压力。关键在于理解它的匹配逻辑和路径拼接规则。
理解 try_files 的执行顺序
它按空格分隔的参数**从左到右依次尝试**：遇到第一个存在的文件或目录就直接返回；若全部不存在，则把最后一个参数作为 URI 重写（内部重定向）或返回状态码。
常见写法：
-
try_files $uri $uri/ /placeholder.png;→ 先找原路径文件，再找同名目录，最后返回 placeholder.png（不跳转，状态码 200） -
try_files $uri @fallback;→ 找不到则交由 named location @fallback 处理（适合做动态兜底或日志记录） -
try_files $uri =404;→ 显式返回 404（比默认行为更明确）
图片缺失时返回默认占位图（最常用）
适用于头像、商品图等场景，要求占位图存在且路径可访问：
- 确保
/var/www/static/images/placeholder.jpg真实存在 - 配置示例：
location /images/ {
alias /var/www/static/images/;
try_files $uri /images/placeholder.jpg;
}注意：$uri 是请求 URI（如 /images/avatar/123.jpg），alias 下路径会替换掉 location 前缀，所以 /images/placeholder.jpg 实际映射为 /var/www/static/images/placeholder.jpg。
兜底到动态服务（如图片裁剪服务）
当需要根据缺失图片的尺寸/格式生成对应占位图时，可交给后端处理：
- 用 named location 拆分逻辑，保持主流程清晰
- 示例：
location /images/ {
alias /var/www/static/images/;
try_files $uri @generate;
}
<p>location @generate {</p><h1>把原始请求路径传给后端，例如 /images/avatar/123.jpg → 后端解析出 123.jpg 并生成</h1><pre class="brush:php;toolbar:false;">proxy_pass http://image_processor;
proxy_set_header X-Original-URI $uri;
}
这样既保留了静态服务性能，又支持灵活兜底逻辑，还便于在 @generate 中加日志或限流。
安全与路径陷阱提醒
容易踩坑的地方：
-
$uri不带 root/alias 路径，只含请求路径；$request_filename才是完整磁盘路径（调试时可用 log_format 打印验证） - 别用
root和try_files混搭时漏掉尾部斜杠 ——root /var/www; try_files $uri /placeholder.png;中，/placeholder.png会被拼成/var/www//placeholder.png（多一个 / 一般不影响，但不推荐） - 避免用
try_files $uri /index.html;这类 SPA 写法处理图片目录，会导致所有图片缺失都返回 HTML，浏览器无法正确解析
