Web Essentials AspNetCore PWA发布至IIS后用IP访问无匹配Service Worker

我基于.Net 6及madskristensen开发的Web Essentials AspNetCore PWA构建了ASP .Net MVC Web应用程序。该应用在Visual Studio本地调试、本地IIS部署环境下均运行正常，但通过IP地址访问部署在IIS上的应用时，出现无匹配Service Worker的问题。

相关环境截图 #

• Visual Studio本地环境：
• 本地IIS环境：
• IP访问IIS环境：

解决建议 #

• 修正Service Worker注册的作用域
  浏览器对Service Worker的作用域有严格限制，注册时如果用相对路径，IP访问时可能导致作用域不匹配。修改注册代码，显式指定根作用域：

  if ('serviceWorker' in navigator) {
      window.addEventListener('load', () => {
          navigator.serviceWorker.register('/service-worker.js', { scope: '/' })
              .then(reg => console.log('Service Worker注册成功:', reg))
              .catch(err => console.error('Service Worker注册失败:', err));
      });
  }
  

  同时检查Web Essentials生成的service-worker.js，确保没有硬编码localhost或特定域名的作用域配置。

• 配置IIS响应头允许Service Worker作用域
  在IIS中为站点添加Service-Worker-Allowed响应头，值设为/，明确允许Service Worker作用于整个应用根目录：

  1. 打开IIS管理器，找到目标站点
  2. 功能视图中选择「HTTP响应头」
  3. 点击「添加」，名称填Service-Worker-Allowed，值填/

• 确保HTTPS访问（核心要求）
  Service Worker仅允许在HTTPS环境运行（localhost除外），如果IP访问用的是HTTP，浏览器会直接阻止注册：

  • 为IIS站点绑定HTTPS证书，访问时使用https://你的IP地址
  • 测试阶段可临时用Chrome启动参数跳过验证：--unsafely-treat-insecure-origin-as-secure="http://你的IP"，但生产环境必须用HTTPS

• 清理浏览器缓存与旧Service Worker
  IP访问时可能残留旧的缓存数据导致不匹配：

  1. 打开浏览器开发者工具（F12）
  2. 切换到「Application」标签，找到「Service Workers」
  3. 点击「Unregister」删除旧的Service Worker，再清除「Cache Storage」中的缓存，重新加载页面

• 检查PWA配置文件
  确认manifest.json中的start_url设置为'/'，而非硬编码的localhost或特定域名；同时检查Web Essentials的PWA生成配置，确保Service Worker的生成路径为应用根目录，没有域名限制。

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