配置 nginx 静态资源缓存回退的核心做法是结合 expires 指令与 try_files 的 fallback 机制。具体而言,在 location 块中设置 expires 以控制浏览器缓存行为,并在 try_files 列表末尾使用 =404 或指向一个自定义错误页作为最终兜底,确保当文件不存在时不会引发内部循环或返回错误的 200 状态。若需实现“缓存命中则直接返回,未命中则尝试其他路径”的逻辑,可利用 $uri 变量配合 try_files 的多级查找,例如先查带哈希的文件,再查原文件,最后回退到默认首页。

如何配置 expires 与 try_files 的基础组合
基础组合的关键在于明确 expires 生效的范围以及 try_files 的匹配顺序。当请求到达时,Nginx 会先检查 try_files 列出的路径是否存在,如果存在且符合 location 定义,则应用该 location 下的 expires 设置。若文件不存在,Nginx 将按顺序尝试下一个路径,直到列表结束。此时若未指定明确的 fallback 响应码,Nginx 可能会执行内部重定向,导致缓存头丢失或返回非预期状态码。因此,必须在 try_files 的最后一步显式指定一个不存在的文件或错误码,如 =404,以终止查找并返回标准错误响应,从而保证缓存策略的纯净性。

server {
listen 80;
server_name example.com;
root /var/www/html;
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
# 设置浏览器缓存时间为 30 天
expires 30d;
add_header Cache-Control "public, immutable";
# 优先查找带版本号的静态文件,若无则查找原文件,最后返回 404
try_files $uri $uri/ =404;
}
location / {
try_files $uri $uri/ /index.html;
}
}
上述配置中,针对静态资源(JS、CSS、图片等)设置了 30 天的强缓存,并通过 immutable 标记告知浏览器资源不会改变。 try_files 首先尝试匹配请求的 URI $uri,如果文件存在,Nginx 直接返回文件并附带 expires 头;如果文件不存在,则尝试将其视为目录 $uri/;若仍不存在,则返回 404 错误。这种结构确保了只有实际存在的静态资源才会被赋予缓存头,避免了为动态接口或错误页面错误地添加缓存指令。
如何实现多级回退与默认首页兼容
多级回退常用于单页应用(SPA)或需要版本控制的场景。在这种模式下,try_files 不仅用于查找文件,还用于构建回退链。例如,可以先尝试查找带有内容哈希的文件(如 app.abc123.js),如果找不到,再尝试查找不带哈希的原文件名(如 app.js),如果还找不到,则回退到 /index.html 以支持 SPA 的路由刷新。这种配置允许服务器在不修改 Nginx 配置的情况下,通过前端构建工具生成的不同文件名自动适应不同的访问情况。关键在于 try_files 的参数顺序必须严格遵循从精确到模糊、从特定到通用的逻辑,且最后一个参数必须是有效的内部重定向目标或错误码。

server {
listen 80;
server_name example.com;
root /var/www/dist;
# 静态资源:优先找哈希文件,其次找原文件,最后 404
location ~* \.(js|css|png|jpg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
try_files $uri $uri.bak =404;
}
# HTML 及根路径:优先找具体文件,其次找目录,最后回退到 index.html
location / {
try_files $uri $uri/ /index.html;
expires off; # HTML 通常不缓存或短缓存
}
}
在这个示例中,静态资源部分引入了 $uri.bak 作为中间回退步骤,模拟了从带哈希文件到备份文件的降级过程。对于 HTML 和根路径,try_files 的最后一步是 /index.html,这是一个内部重定向,意味着如果用户访问 /about 且服务器上不存在 /about 文件或目录,Nginx 会将请求内部转发给 /index.html,由前端路由处理 /about 路径。同时,HTML 文件设置了 expires off,确保每次请求都向服务器验证,避免用户看到过时的页面内容。这种分离配置既保证了静态资源的长期缓存效率,又确保了动态内容的实时性。
当 try_files 找不到文件时返回什么状态码
当 try_files 列表中所有指定的文件和目录都不存在,且最后一步不是内部重定向而是错误码时,Nginx 将直接返回该错误码对应的 HTTP 状态。例如,如果 try_files 以 =404 结尾,且前面所有路径均未匹配成功,Nginx 会返回 404 Not Found 状态码。如果最后一步是另一个文件路径(如 /fallback.html),则 Nginx 会内部重定向到该文件,并返回 200 OK 状态码,内容为 /fallback.html 的内容。重要的是,try_files 的行为完全取决于其最后一个参数:如果是文件路径,则是内部重定向(200);如果是错误码(如 =404),则是直接返回该错误码(404)。这一机制使得开发者可以精确控制资源缺失时的用户反馈,无论是显示友好的错误页面还是标准的 404 响应。


















