try_files 是 Nginx 实现静态资源优先、后端兜底的核心指令，按空格分隔顺序检查文件或目录存在性，命中即返回，全不命中则跳转至命名 location（如 @backend）或状态码；不可直接写 proxy_pass，须配合 location @backend { proxy_pass ... } 实现后端转发。
try_files 是 Nginx 中用于按顺序检查文件或路径是否存在，并在全部失败时触发一个“兜底”动作（如内部重定向或返回状态码）的指令。它本身不直接转发请求到后端，但可以配合 location 块和 proxy_pass 实现“静态资源优先，缺失则交由后端处理”的常见需求（例如 SPA 的 history 模式、API 回退等）。
核心用法：用 try_files 触发内部重定向到命名 location
最常用且推荐的方式是让 try_files 最后一项指向一个 命名 location（以 @ 开头），然后在该 location 中使用 proxy_pass 转发到后端服务。
示例配置：
location / {
# 尝试匹配：1. 请求路径本身（如 /app.js）；2. 加 .html 后缀（如 /about → /about.html）；3. 兜底到 @backend
try_files $uri $uri/ @backend;
}
<h1>命名 location，仅用于内部跳转，不匹配原始请求路径</h1><p>location @backend {
proxy_pass <a href="https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1">https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1</a>; # 后端地址
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}</p>✅ 这样配置后：
- 请求
/style.css→ 文件存在 → 直接返回静态文件 - 请求
/api/users→ 文件不存在 → 跳转到@backend→ 代理到 Node.js 后端 - 请求
/dashboard（前端路由）→ 静态文件无此路径 → 触发@backend→ 后端可返回 index.html 或由前端接管
注意：不能直接在 try_files 里写 proxy_pass
try_files 的最后一项必须是 URI（如 /index.html）、状态码（如 =404）或命名 location（如 @backend）。它不支持直接写 proxy_pass 地址。以下写法是错误的：
# ❌ 错误！try_files 不接受 proxy_pass 作为参数 try_files $uri @backend https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1;
常见变体：适配单页应用（SPA）
对于 React/Vue 等前端项目，通常希望所有非静态资源的请求都返回 index.html，再由前端路由处理。此时可这样写：
location / {
root /var/www/my-spa;
try_files $uri $uri/ /index.html; # 所有未命中都返回根目录下的 index.html
}⚠️ 注意：/index.html 是相对于 root 的路径，不是绝对系统路径。如果需走后端渲染（比如 SSR），仍应使用 @backend 方式。
调试技巧：确认是否真进了 try_files 的兜底分支
可在命名 location 中加日志或临时返回标识，验证逻辑是否生效：
location @backend {
# 临时调试：返回明确提示（上线前删掉）
# return 200 "Proxying to backend: $request_uri";
<pre class="brush:php;toolbar:false;">proxy_pass https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1;
# ... 其他 proxy 设置}
同时检查 Nginx 错误日志（error_log）和访问日志，确认请求是否被正确路由，避免因 root、alias 或路径拼接问题导致误判。
