pragma: no-cache 是 http/1.0 遗留字段,优先级高于 cache-control,只要存在即强制禁用缓存,即使配置了 max-age 也无效;需通过 nginx 的 proxy_ignore_headers pragma 或源站修复来绕过。

Pragma: no-cache 是 HTTP/1.0 的遗留字段,虽已由 Cache-Control 取代,但很多后端(尤其是 Java Servlet、Spring Boot 或老旧网关)仍会默认携带它。只要响应中存在 Pragma: no-cache,主流 CDN(如腾讯云 EdgeOne)、反向代理(如 Nginx)和浏览器都会将其视为“禁止缓存”的强信号,直接跳过缓存逻辑——哪怕你配置了 max-age=31536000 也无效。
确认是否真被 Pragma 阻断
用 curl 抓取原始响应头,重点看三处:
- 执行 curl -I https://yoursite.com/static/app.js,检查返回中是否含 Pragma: no-cache(注意大小写)
- 同时观察 X-Edge-Cache(EdgeOne)或 X-Cache-Status(Nginx)是否持续为 MISS
- 对比同一资源在禁用浏览器缓存(DevTools → Network → ✅ Disable cache)下能否正常回源更新;若禁用后能刷新,而开启后始终不发请求,说明缓存策略被硬性拦截
Nginx 环境:用 proxy_ignore_headers 跳过干扰
不是删除 Pragma 头,而是让 Nginx 在做缓存决策时彻底忽略它:
- 确保 proxy_ignore_headers 放在 proxy_pass 之前,且仅在对应 location 块内生效
- 写法必须严格:proxy_ignore_headers Pragma;(区分大小写,不能写 pragma 或 Pragma: no-cache)
- 必须搭配 proxy_cache_valid 显式定义缓存规则,例如:proxy_cache_valid 200 302 1y;
- 别忘了启用缓存区:proxy_cache my_cache;(需在 http 块中提前定义 proxy_cache_path)
源站侧:优先修复根本原因
Pragma: no-cache 往往是后端框架自动注入的,尤其在未显式设置响应头时:
- Spring Boot 中检查是否误用了 @CacheControl 注解或全局拦截器强制加了 Pragma
- Java Servlet 中排查 response.setHeader("Pragma", "no-cache") 这类硬编码
- 静态资源路径(如 /static/、/_next/static/)建议统一由 Web 容器或 CDN 直接服务,绕开业务层中间件
- 若无法改源码,可在 Nginx 或 EdgeOne 规则中增加“修改响应头”操作,显式覆盖或清除 Pragma 字段
验证缓存是否真正生效
改完配置后,不只看头字段是否存在,要验证行为:
- 首次访问资源,响应头中仍可见 Pragma: no-cache(说明没删头),但同时出现你注入的 Cache-Control: public, max-age=31536000
- 第二次访问,X-Cache-Status 变为 HIT,且响应时间明显下降
- 浏览器 Network 面板中该资源 Size 列显示 from memory cache 或 from disk cache











