nginx 中可通过 expires 1y 为图片设置一年缓存，需在 location ~* .(jpg|jpeg|png|gif|webp|ico|svg)$ 块中配置，并补充 add_header cache-control "public, immutable"；必须确保 location 优先级高于通用规则、资源由 nginx 直接响应且 url 带哈希以避免更新失效。
在 Nginx 中，可以通过 expires 指令为图片等静态资源设置浏览器缓存时间，比如缓存一年。这不需要额外加载模块——expires 是 Nginx 的核心模块（ngx_http_headers_module）内置功能，只要 Nginx 正常安装就可用。
确认图片资源匹配规则
要让 expires 生效，需确保请求确实命中了你配置的 location 块。常用做法是按文件后缀匹配图片资源：
location ~* \.(jpg|jpeg|png|gif|webp|ico|svg)$ { ... }-
~*表示不区分大小写的正则匹配 - 注意避免和更宽泛的 location（如
/或^~ /static/）产生冲突，优先级高的会覆盖低优先级的 expires 设置
设置 expires 为 1 年
在匹配图片的 location 块中添加 expires 指令：
location ~* \.(jpg|jpeg|png|gif|webp|ico|svg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
-
expires 1y表示设置Expires响应头为当前时间 + 1 年，同时自动添加Cache-Control: max-age=31536000 - 建议加上
add_header Cache-Control "public, immutable"：其中public允许中间代理缓存，immutable告诉浏览器该资源内容不会变更（配合版本化文件名更有效） - 注意：
expires只对状态码为 200、201、204、206、301、302、303、304、307 的响应生效
验证缓存头是否生效
重启 Nginx 后，用浏览器开发者工具或 curl 检查响应头：
curl -I https://your-site.com/logo.png
应看到类似：
Cache-Control: public, immutable, max-age=31536000Expires: [未来某年某月某日]
若未出现，检查是否被其他 location 或 upstream（如反向代理）覆盖了响应头；也可临时加 add_header X-Debug "cached" 辅助定位配置是否命中。
注意事项与常见问题
实际使用中需注意几个关键点：
- 修改配置后必须执行
nginx -t && nginx -s reload，仅 restart 不够可靠 - 如果图片 URL 不带版本号或哈希（如
logo.png?v=1.2或logo.a1b2c3.png），更新图片后用户可能因强缓存看不到新图——建议配合构建工具生成带哈希的文件名 -
expires对动态生成的图片（如 PHP 输出的 png）无效，除非它们也返回 200 状态且未被 proxy_pass 等指令拦截响应头 - 某些 CDN 或前端代理可能清除或重写
Cache-Control，需在对应层同步配置
