IIS静态内容缓存怎样设置有效期?如何确认浏览器拿到的是缓存版本
图片已经改了,浏览器却还显示旧图;打开开发者工具又看到状态码为 200,于是有人判断“IIS 缓存没有生效”。这两个判断都可能不对:旧图可能正是浏览器按有效期使用了本地副本,而 200 (from disk cache) 也不代表文件重新从服务器下载。
设置 IIS 静态内容缓存有效期,通常是在静态资源所在目录的 web.config 中配置 system.webServer/staticContent/clientCache,让响应带上 Cache-Control: max-age=...。确认浏览器是否拿到缓存版本,则要结合开发者工具中的传输来源、请求与响应头,以及重复访问时是否发生网络请求来判断,不能只看状态码或页面外观。
先分清:要设置的是哪一层缓存
“静态内容缓存”容易把几个不同位置混在一起。本文要解决的主要是浏览器缓存:IIS 返回 CSS、JavaScript、图片、字体等文件时附带缓存响应头,浏览器据此决定本地副本还能用多久。
IIS 的服务端缓存是另一回事。即使服务器内部复用了某个响应,也不能据此推断浏览器没有发请求。站点接入 CDN 时,边缘节点还可能在浏览器与 IIS 之间缓存文件;边缘节点命中同样不等于浏览器本地命中。三者应分别观察:
| 缓存位置 | 主要控制或影响因素 | 验证重点 |
|---|---|---|
| 浏览器 | Cache-Control、资源 URL、浏览器缓存状态 | 第二次加载是否直接使用内存或磁盘副本 |
| IIS 服务端 | IIS 对相应内容的服务端缓存配置 | 请求是否到达 IIS、服务器如何处理 |
| CDN 边缘节点 | CDN 缓存规则、响应头及缓存键 | 请求是否到达边缘节点、边缘是否回源 |
本文的 clientCache 配置针对静态文件的客户端缓存响应头,不能代替 CDN 规则,也不应当作动态页面的统一缓存开关。若 /index.html 由静态文件模块提供,它也可能受到所在目录静态内容缓存策略影响;若页面由应用程序生成,就需要检查应用程序实际返回的响应头。
有效期为什么会影响“更新是否可见”
浏览器首次请求 /assets/site.css,收到文件内容及 Cache-Control: max-age=604800 后,可以在响应仍然新鲜的期间复用该副本。604800 的单位是秒,即 7 天。在这段时间里,如果服务器只修改文件内容、URL 仍是 /assets/site.css,浏览器可能根本不向服务器询问,自然也不会知道文件已经更新。
有效期过后,情况又不同。若响应有 ETag 或 Last-Modified 等验证信息,浏览器可以发送条件请求;服务器确认文件未变化时返回 304 Not Modified,浏览器继续使用本地文件内容。304 表示发生了网络验证,不表示重新下载了完整文件;直接从本地缓存读取则可能连这次验证请求都没有。

这也解释了为什么“设置长有效期”和“发布后立即更新”通常需要配套设计:
- 文件名随内容变化的资源,例如
/assets/site.a83f2c.css,适合设置较长有效期。内容变化时发布新 URL,浏览器会把它视为新资源。 - 文件名固定且会原地覆盖的资源,适合较短有效期,或接受更新在有效期内不能及时可见的结果。
- 入口 HTML 通常承担引用新版资源的任务。如果它长期保持旧版本,浏览器即使能够获取带新文件名的 CSS,也可能一直不知道该请求哪个 URL。
这里的关键不是“7 天是否合理”,而是旧 URL 在 7 天内是否仍代表同一份内容。对版本化资源,较长有效期可以减少重复请求;对需要随时替换的同名文件,它会放大更新延迟。
在 IIS 中把策略限定到合适的目录
例如,站点将带版本号或内容哈希的 CSS、JavaScript、图片集中放在 /assets/,可以在该目录的 web.config 中设置:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<staticContent>
<clientCache cacheControlMode="UseMaxAge"
cacheControlMaxAge="7.00:00:00" />
</staticContent>
</system.webServer>
</configuration>
7.00:00:00 表示 7 天,预期响应头中的 max-age 为 604800 秒。把配置放在 /assets/,比直接给整个站点设长有效期更容易控制影响范围:根目录的 HTML、下载文件或其他静态内容不必跟着使用同一策略。
修改前应先确认该目录是否已有 web.config 或上级继承配置,备份原文件,并把配置合并到现有结构中,不要机械地再写一个同名节点。保存后先请求一份目标静态文件检查响应头,同时检查页面能否正常访问。如果配置不被当前站点允许、XML 有误或出现重复配置,应恢复备份并检查 IIS 返回的配置错误;不要在尚未确认影响范围时批量改动站点目录。
如果资源没有版本化,可以先按更新频率选择更短的有效期,再用实际发布流程验证。例如,一张可能当天反复替换的同名活动图,不宜仅因为它是图片就套用数月缓存。反过来,缩短 max-age 也不保证每次访问都重新下载:过期后的条件请求仍可能得到 304,这通常是正常且有益的结果。
哪些因素会改变实际看到的结果
请求 URL 是缓存匹配的起点。 /assets/site.css?v=1 与 /assets/site.css?v=2 是不同 URL;查询参数能否作为发布版本标识,还取决于 CDN 是否保留它、缓存键是否包含它,以及页面是否确实更新了引用。若可控制构建流程,内容变化即更换文件名通常更直观。
响应头要以最终到达浏览器的版本为准。 应用程序、中间层或 CDN 可能添加、覆盖缓存头。查看服务器上的 web.config 只能证明配置意图;浏览器收到 Cache-Control: no-store、较短的 max-age 或其他策略时,应按实际响应继续查明是哪一层设置的。若使用了 CDN,还要分别检查浏览器响应、边缘缓存规则和回源响应,不能用浏览器命中反推 CDN 命中。
验证信息不等于有效期。 ETag、Last-Modified 主要用于过期后的条件验证;它们的存在不能证明浏览器会在有效期内请求服务器。多台服务器发布同一 URL 时,也要确认内容及验证信息一致,否则可能出现不必要的重新下载或更新判断异常。
敏感或个性化内容不应套用公共静态资源策略。 带用户信息的下载结果、登录后生成的页面,即使看起来像文件,也应先按内容是否可共享、是否允许本地保存来设计缓存。no-cache 的含义是使用前需要验证,并不等同于禁止保存;需要禁止存储时应评估 no-store。不要把这类内容与公开的版本化图片一起放进长期缓存目录。
怎样证明浏览器确实用了缓存版本
验证最好分成两步:先确认服务器发出了什么缓存规则,再确认浏览器在重复访问时做了什么。只做其中一步都不够。
第一步:核对实际响应头
选择一个明确位于目标目录的资源,先检查响应头。以下地址仅作示例:
curl -I https://www.example.com/assets/site.a83f2c.css
重点看 Cache-Control 是否包含预期的 max-age=604800,并记录 ETag、Last-Modified、Date 等头。curl -I 使用的是 HEAD 请求,适合初步核对响应头,但不能证明浏览器已经从本地缓存读取。如果经过 CDN,这里看到的是访问路径最终返回的头;要定位规则来源,还需要结合 CDN 配置及回源响应检查。
随后可用浏览器正常加载包含该资源的页面。打开开发者工具的“网络”面板,确保“禁用缓存”没有勾选,不使用强制刷新。可以从页面 A 正常导航到同样引用该资源的页面 B,观察第二次加载,避免把强制刷新造成的重新请求误认为缓存失效。
第二步:同时看状态、传输量和请求头
不同浏览器的界面文字略有差异,判断逻辑可以按下表进行:
| 第二次加载的观察结果 | 通常意味着什么 | 还需核对什么 |
|---|---|---|
显示 200 (from memory cache) 或 200 (from disk cache),传输量很小或不显示网络下载 | 浏览器直接使用本地副本 | URL 是否完全相同;是否有 Service Worker 介入 |
出现网络请求,状态为 304 | 浏览器向服务器或中间层完成条件验证,复用了本地文件内容 | 请求中的 If-None-Match 或 If-Modified-Since,以及缓存有效期是否已过 |
出现网络请求,状态为 200 且重新传输了文件内容 | 本次未直接复用本地内容 | 是否强制刷新、禁用缓存、URL 改变,或响应策略要求重新获取 |
因此,看到普通 200 不足以断言缓存失败,必须看它是“来自磁盘/内存”,还是确实传输了响应体。同样,看到 304 说明省去了重新传输文件内容,但它不是有效期内“完全不发请求”的命中方式。
如果怀疑旧文件来自其他机制,可再检查网络面板是否标注 Service Worker,核对完整 URL(包括查询参数),并在需要时查看服务端或 CDN 请求记录。开发者工具的“禁用缓存”、强制刷新、隐私窗口、清理站点数据等操作都会改变实验条件;比较前后结果时应保持访问方式一致。
还可以用条件请求辅助验证过期后的行为:从首次响应中复制原样的 ETag,再发起请求。例如:
curl -I \
-H 'If-None-Match: "从首次响应复制的ETag"' \
https://www.example.com/assets/site.a83f2c.css
若返回 304,说明本次请求路径对该验证条件判定为未变化;若返回 200,需结合实际 ETag、资源内容及中间层行为判断。这个测试模拟的是条件验证,不是浏览器本地命中测试,不能替代网络面板中的重复加载观察。
用验证结果决定有效期,而不是反过来猜
长期缓存适用于 URL 随内容变化、允许浏览器继续使用旧 URL 对应旧内容的公开资源。更新频繁且保持同一 URL 的文件,应缩短有效期,或改造发布方式;入口 HTML 则要确保能在预期时间内让访问者发现新版资源。
验收时可抓住三个对应关系:配置的目录是否就是目标文件所在目录;最终响应头的 max-age 是否符合发布策略;同一 URL 在正常重复访问时,浏览器是直接读取本地副本、发出条件请求,还是重新下载。只有把这三项与“内容更新后是否更换 URL”一起核对,才能判断看到旧内容是预期的缓存行为,还是需要调整的失效策略。
对于运行 IIS 网站、发布 CSS、JavaScript 和图片等静态资源的业务,A5idc数据提供中国香港、美国、日本、新加坡等地区的物理服务器。不同产品系列配有 SSD 或 NVMe 存储,并提供相应的带宽与线路选择,可为企业网站的页面和静态文件提供部署资源,也为面向不同地区访客的站点安排提供选择。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7247.html