用 try_files 实现静态缓存需将缓存路径置首，如 try_files /var/cache/nginx$uri.json @backend；缓存文件须含完整http响应（状态行、头、空行、正文）；兜底必须用命名location；路径须绝对且nginx有读权限。

用 try_files 让 Nginx 优先读取本地静态缓存文件，核心是把缓存路径放在检查列表最前面，命中就直接返回，不命中再走后端。这不是自动缓存机制，而是“先查磁盘、再回源”的显式路径判断。

缓存路径要能映射到请求 URI

Nginx 不会自己把 /api/user/123 转成缓存文件名，你得手动约定规则。常见做法有：

• 直接拼接：/var/cache/nginx$uri（适合简单路径，但要注意 .. 和斜杠安全）
• 用 map 过滤转义：map $uri $cache_key { ~^(?<safe>.+)$ $safe; default ""; }</safe>，再拼成 /var/cache/nginx/$cache_key
• 加统一后缀：/var/cache/nginx$uri.json，对应 try_files 写成 try_files /var/cache/nginx$uri.json @proxy;

缓存文件必须是完整 HTTP 响应

try_files 返回的是纯文件内容，Nginx 不解析也不补头。所以缓存文件里得自带状态行、响应头和空行，例如：

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 15

{"id":123,"name":"Alice"}

实际中建议用脚本或 Lua 预生成这类文件；不推荐手写，容易出错。如果只是 JSON 或 HTML 片段，可配合 add_header 补关键头：

linux-sysadmin

Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...

下载

• add_header Content-Type "application/json";
• add_header Cache-Control "public, max-age=3600";

兜底转发要用命名 location

最后一个参数不能是 proxy_pass 直写，必须是 @named_location。例如：

• try_files /var/cache/nginx$uri @backend;
• location @backend { proxy_pass http://upstream; }

这样既保持配置清晰，也方便后续加健康检查、降级或日志。注意：Nginx worker 用户（如 www-data）必须对缓存目录有读权限，否则始终 403。

别忘了 root 和权限校验

如果你的缓存放在非默认路径（比如 /data/cache），try_files 中的路径就得写绝对路径，且确保 Nginx 有权限读取。不要依赖 root 拼接——try_files 的路径不是相对 root 的，除非你用 $uri 这类变量且没加前缀。

• 错误写法：root /data/cache; try_files $uri @proxy;（$uri 仍按原始请求路径拼，不是拼到 /data/cache）
• 正确写法：try_files /data/cache$uri @proxy;