nginx 通过 map 指令实现动态缓存时间，本质是“先映射、再调用”：在 http 块顶层定义变量映射规则生成缓存时长值，再在 location 或 server 块中用 expires 或 proxy_cache_valid 引用；推荐按 $sent_http_content_type（最可靠）或 $request_uri（较常用）匹配；示例中 default "epoch" 兜底，正则 ~*^text/css "1m" 等设定各类资源缓存时长；浏览器缓存用 expires $cache_ttl，反代缓存需 proxy_cache_valid 配合整数秒变量或分支；精细控制推荐 add_header cache-control ... always；调试需验证响应头、错误日志及后端 content-type 是否缺失。
Nginx 通过 map 指令实现动态缓存时间，本质是“先映射、再调用”：在 http 块中定义变量映射规则，生成缓存时长值；再在 location 或 server 块中用 expires 或 proxy_cache_valid 引用该变量。它比写一堆 location ~ \.js$ { } 更清晰、易维护，也避免规则冲突。
在 http 块中定义映射变量
必须放在 http { } 顶层，不能嵌套在 server 或 location 内。推荐两种匹配依据：
-
按响应 Content-Type（最可靠）：使用
$sent_http_content_type，真实反映后端返回的 MIME 类型，防伪造后缀或路径重写干扰 -
按请求 URI 后缀（较常用）：使用
$request_uri或$uri，正则匹配更直观，适合静态资源明确的场景
示例（基于 Content-Type）：
map $sent_http_content_type $cache_ttl {
default "epoch";
~*^text/html "0";
~*^text/css "1M";
~*^application/javascript "1M";
~*^image/ "1y";
~*^font/ "1y";
~*^application/font- "1y";
}
说明："epoch" 表示立即过期；"0" 表示每次验证；"1M" 是 1 个月（注意 Nginx 中 M 表示月，m 表示分钟）；正则前加 ~* 表示忽略大小写；default 必须存在，兜底防空值。
在 location 中应用缓存变量
只需一行指令即可生效，无需重复判断后缀：
- 控制浏览器缓存：用
expires $cache_ttl;—— 自动设置Expires和Cache-Control: max-age= - 控制 Nginx 本地反代缓存：用
proxy_cache_valid 200 302 $cache_ttl;—— 注意：Nginx 不允许直接在proxy_cache_valid中使用变量，需配合多行声明或间接方式（如用 map 输出整数秒，再结合多个proxy_cache_valid分支）
若需精细控制 Cache-Control（比如加 immutable），建议改用：
add_header Cache-Control "public, max-age=31536000, immutable" always;
always 确保 304、4xx 等非 2xx 响应也携带该头，避免策略丢失。注意：如果同时用了 expires 和 add_header Cache-Control，前者会覆盖后者中的 max-age，所以推荐统一用 add_header 主控，仅保留 expires 作 IE 兼容。
常见类型与推荐缓存时长
合理设置能兼顾性能与更新及时性：
-
text/html、application/json、text/xml：设为"0"或"epoch"，强制不缓存或每次验证 -
text/css、application/javascript、font/*：设为"1y"或"1M"，配合文件哈希可长期缓存 -
image/*（jpg/png/webp等）：设为"1y"，CDN 和浏览器都可复用 -
favicon.ico、robots.txt：设为"1m"或"1h"，兼顾稳定性和可更新性
对带哈希的静态资源（如 app.a1b2c3.js），强烈建议启用 immutable，浏览器将跳过条件请求，显著减少 304。
调试与验证要点
配置完成后务必验证是否生效：
- 用
curl -I https://yoursite.com/style.css查看响应头中Expires和Cache-Control是否符合预期 - 检查 Nginx 错误日志：
tail -f /var/log/nginx/error.log，确认无map变量未定义或正则语法错误 - 用
nginx -t验证配置语法，再systemctl reload nginx生效 - 若发现某类资源始终走默认值，检查后端是否漏发
Content-Type头（$sent_http_content_type为空时会落入default分支）
