Nginx 中 map 指令可基于 $sent_http_content_type 或 $request_filename 动态生成 $expires_time 等变量，再配合 expires 指令实现按 MIME 类型或文件扩展名差异化设置客户端缓存时间，配置简洁、可维护性强；需将 map 定义在 http 块顶层，expires 放在 server 或 location 中生效，并注意响应头覆盖与匹配时机。
在 Nginx 中，map 指令可以基于请求变量（如 $sent_http_content_type 或 $request_filename）动态生成新变量，再配合 expires 指令，就能为不同文件类型设置差异化的缓存时间，比硬编码 location 块更简洁、可维护性更强。
用 map 匹配 Content-Type 设置缓存时长
这是最常用且可靠的方式：Nginx 在响应头已确定（即内容类型已识别）后，通过 $sent_http_content_type 变量匹配 MIME 类型，再映射出对应的缓存时间值。需注意该变量仅在响应阶段可用，因此 map 块必须定义在 http 块中，且 expires 需放在 server 或 location 中生效。
示例配置：
http {
map $sent_http_content_type $expires_time {
default "epoch";
~*^text/ "1h";
~*^application/javascript "1h";
~*^application/css "1h";
~*^image/ "1w";
~*^font/ "1y";
~*^application/font- "1y";
~*^application/vnd.ms-fontobject "1y";
}
<pre class="brush:php;toolbar:false;">server {
listen 80;
root /var/www/html;
location / {
expires $expires_time;
}
}
}
-
正则匹配要加
~*：不区分大小写，避免因 MIME 大小写不一致（如Image/PNG）导致匹配失败 -
默认设为
"epoch"：等效于Expires: Thu, 01 Jan 1970 00:00:01 GMT，强制不缓存；也可用"off"关闭 expires，但此时仍可能受 Cache-Control 影响 -
字体类型要覆盖全：常见字体 MIME 包括
font/woff2、font/ttf、application/font-woff、application/vnd.ms-fontobject，建议统一设为 1 年
用 map 基于文件扩展名预判缓存策略
若需在响应前就决定缓存行为（例如静态资源路径固定、希望更早介入），可用 $request_filename 或 $uri 配合扩展名匹配。这种方式不依赖后端或静态文件实际返回的 Content-Type，适合纯静态服务场景。
示例：
map $request_filename $expires_by_ext {
default "epoch";
~*\.(js|css|json|xml)$ "1h";
~*\.(png|jpe?g|gif|webp)$ "1w";
~*\.(woff2|woff|ttf|eot)$ "1y";
}
<p>server {
location /static/ {
expires $expires_by_ext;
}
}</p>-
优先使用
$request_filename：它包含完整物理路径，能准确反映真实文件，避免 URI 重写干扰；若文件未落盘（如由 Lua 或 proxy_pass 动态生成），则改用$uri -
正则末尾加
$：防止误匹配（如script.js?v=123中的.js仍能正确捕获） -
不推荐仅靠
$uri匹配：URI 可能含查询参数或被重写，稳定性不如文件系统判断
注意事项与调试技巧
动态 expires 生效依赖变量计算时机和响应头写入顺序。常见问题可通过日志和响应头验证。
- 确保 map 定义在 http 块顶层：不能嵌套在 server 或 location 内，否则 Nginx 启动会报错
-
检查响应头是否被覆盖：如果后端应用（如 PHP、Node.js）也设置了
Cache-Control或Expires，会覆盖 Nginx 的设置。可在 location 中加add_header Cache-Control "" always;清除旧头（慎用），或统一由 Nginx 控制 -
用 curl 快速验证：
curl -I https://example.com/style.css查看Cache-Control和Expires字段；配合-v可看完整流程 -
启用 Nginx debug 日志临时排障：在 error_log 中设
debug级别，可看到 map 变量的匹配过程（注意仅用于调试，线上勿开）
进阶：结合版本号实现长期缓存 + 缓存失效
单纯按类型设长缓存还不够——文件内容更新后，浏览器仍会加载旧缓存。理想做法是「内容不变则永久缓存，内容一变则 URL 改变」。通常通过构建工具在文件名中加入哈希（如 main.a1b2c3.js），再配合 map 将这类资源设为 1 年缓存：
map $request_filename $expires_versioned {
default "epoch";
~*\.[0-9a-f]{6,}\.(js|css|png|jpg|gif)$ "1y";
~*\.[0-9a-f]{8,}\.(woff2|ttf)$ "1y";
}
<p>location /assets/ {
expires $expires_versioned;
}</p>-
正则聚焦哈希特征：如 Webpack 输出的
app.3e4a2d.js，用\.[0-9a-f]{6,}\.js精准识别，避免误伤普通app.js - 与 HTML 分离部署：HTML 设短缓存（如 10 分钟），内联资源链接带哈希，既保证 HTML 及时更新，又让静态资源享受强缓存
- CDN 场景下同样适用：只要 CDN 支持透传或覆盖响应头（如 Cloudflare Page Rules、阿里云 CDN 自定义响应头），该方案可无缝延伸
