Nginx通过try_files指令实现本地静态文件优先：按顺序检查$uri.html、$uri/等路径，命中则直接返回，未命中时跳转@backend回源；需正确配置root、权限及响应头。
要让 Nginx 优先使用本地静态文件（如缓存的 HTML、JSON 或预生成页面），仅在本地不存在时才转发请求到后端（如 PHP-FPM、Node.js 或上游服务），核心就是用 try_files 指令按顺序检查文件是否存在，并设置合适的 fallback。
理解 try_files 的执行逻辑
try_files 不是“缓存策略”，而是“文件存在性检查 + 路径回退”机制。它从左到右依次尝试每个参数：如果当前参数代表的文件或目录存在且可读，就直接返回该资源；否则继续下一个。最后一个参数必须是内部 URI（以 / 开头）或 HTTP 状态码（如 =404），用于兜底处理。
本地缓存优先的关键，在于把静态缓存路径放在前面，后端代理逻辑（如 @backend）放在最后。
典型配置：静态缓存目录 + 后端回退
假设你把渲染好的页面缓存到 /data/cache/，按请求路径哈希或原路径组织（例如 /data/cache/article/123.html），可这样写：
location / {
# 尝试匹配缓存文件：先查带 .html 后缀的，再查不带后缀的目录（适配 SPA）
try_files $uri.html $uri/ @backend;
<pre class='brush:php;toolbar:false;'># 若匹配到 $uri.html 存在，直接返回；若 $uri/ 是目录且含 index.html，也返回
# 都不满足，则跳转到 @backend}
后端代理块
location @backend { proxy_pass https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }
进阶：支持多级缓存路径与变量拼接
若缓存路径含时间戳、版本号或用户维度（如登录态缓存），可用 map 或 rewrite 预处理 $uri，再传给 try_files。常见做法：
- 用
map根据请求头（如 Cookie）生成缓存子目录名，例如$cache_key - 在
location中用root /data/cache/$cache_key;，再配合try_files $uri.html $uri/ =404; - 避免在
try_files中直接拼接变量（Nginx 不支持），必须通过root或alias定义基础路径
注意点与常见坑
以下细节容易导致“缓存不生效”或“误转发”：
-
root 和 alias 区别：用
root时，Nginx 把$uri全路径拼在 root 后；用alias时，会替换 location 匹配部分 —— 缓存场景推荐root，更直观 -
结尾斜杠影响：访问
/article/123时，$uri是/article/123；若服务器实际缓存为/article/123/index.html，需写成try_files $uri/index.html $uri.html $uri/ @backend -
权限与 SELinux：确保 Nginx worker 进程对缓存目录有读取权限；SELinux 启用时可能拦截，可用
ls -Z /data/cache检查上下文 -
不触发后端不代表缓存命中：即使
try_files返回了文件，仍需确认响应头是否含Cache-Control，否则浏览器或 CDN 不会复用
