IIS Windows服务器上PWA与Service Worker缓存优先级问题求助

绝对遇到过！我之前把PWA部署到IIS Windows服务器时，也踩过一模一样的坑——本地测试时Service Worker更新逻辑完美运行，一到生产环境就彻底失效，后来排查发现就是IIS默认的缓存策略在“抢风头”，要么是Service Worker文件本身被服务器缓存了，要么是静态资源的缓存优先级盖过了SW的缓存机制。下面是我亲测有效的解决办法：

1. 禁止IIS缓存Service Worker核心文件 #

Service Worker文件（通常是sw.js）是PWA的“指挥中心”，如果IIS把它缓存了，浏览器就会一直用旧版本，根本不会触发更新流程。你需要在项目根目录的Web.config里添加针对性的缓存规则：

<!-- 针对sw.js禁用缓存，确保浏览器每次都从服务器拉取最新版本 -->
<location path="sw.js">
  <system.webServer>
    <httpProtocol>
      <customHeaders>
        <add name="Cache-Control" value="no-cache, no-store, must-revalidate" />
        <add name="Pragma" value="no-cache" />
        <add name="Expires" value="0" />
      </customHeaders>
    </httpProtocol>
  </system.webServer>
</location>

这个配置会让浏览器每次请求sw.js时都必须和服务器验证是否有新版本，彻底避免服务器缓存SW文件。

2. 给静态资源配置合理缓存规则（配合SW更新） #

对于JS、CSS、图片这类静态资源，我们可以让IIS设置长期缓存，但前提是给资源文件名加上哈希后缀（比如app.abc123.js）——这样资源更新时文件名会变化，Service Worker能自动识别并更新缓存。对应的Web.config配置：

<!-- 给带哈希的静态资源设置长期缓存 -->
<staticContent>
  <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="365.00:00:00" />
</staticContent>

注意这个规则不会影响我们刚才单独配置的sw.js，因为<location>标签的优先级更高。

3. 在代码中主动触发SW更新检查 #

即使配置了缓存规则，也可以在页面加载时主动触发Service Worker的更新检查，确保用户能及时拿到新版本：

if ('serviceWorker' in navigator) {
  window.addEventListener('load', async () => {
    try {
      const registration = await navigator.serviceWorker.register('/sw.js');
      // 主动检查SW更新
      await registration.update();
      
      // 监听更新事件，提示用户刷新
      registration.addEventListener('updatefound', () => {
        const newWorker = registration.installing;
        newWorker.addEventListener('statechange', () => {
          if (newWorker.state === 'installed' && navigator.serviceWorker.controller) {
            // 这里可以换成更友好的弹窗提示
            if (confirm('检测到新版本，是否立即刷新获取更新？')) {
              window.location.reload();
            }
          }
        });
      });
    } catch (error) {
      console.error('Service Worker注册失败:', error);
    }
  });
}

4. 验证配置是否生效 #

配置完成后，用浏览器开发者工具的「Network」标签，查看sw.js的响应头，确认Cache-Control是no-cache, no-store, must-revalidate，没有被缓存。如果还是有问题，可以重启IIS服务，或者手动清理IIS的服务器端缓存（IIS管理器→对应站点→功能视图→「输出缓存」→清除缓存）。

我当时就是靠这几步解决了问题，你可以试试，要是还有细节问题，比如Web.config路径不对、文件名不匹配，再针对性调整就行。

内容的提问来源于stack exchange，提问作者Alex