Blazor WASM PWA懒加载模块被Service Worker预缓存是否正常？

核心结论 #

这不属于正常行为，Blazor WASM的懒加载机制完全支持PWA场景。问题根源是构建时生成的service-worker-assets.js错误包含了blazor.boot.json中标记为lazyAssembly的模块，导致Service Worker初始化时就缓存了这些本该按需加载的文件。

解决方案 #

1. 修正.csproj配置

在项目的.csproj文件中添加以下配置，确保构建系统将懒加载程序集排除在Service Worker的预缓存清单之外：

<!-- 已有的懒加载程序集标记 -->
<ItemGroup>
  <BlazorWebAssemblyLazyLoad Include="YourLazyAssembly.dll" />
  <!-- 多个懒加载程序集可重复添加 -->
</ItemGroup>

<!-- 新增：排除懒加载程序集出Service Worker缓存清单 -->
<PropertyGroup>
  <ServiceWorkerAssetsManifestExclude>$(BlazorWebAssemblyLazyLoad)</ServiceWorkerAssetsManifestExclude>
</PropertyGroup>

这个配置会让service-worker-assets.js生成时自动忽略所有标记为懒加载的程序集，避免Service Worker提前缓存它们。

2. 验证构建结果

发布项目后，检查wwwroot/service-worker-assets.js文件，确认其中没有包含你的懒加载dll文件；同时核对blazor.boot.json，确认对应程序集的lazyAssembly属性为true。

3. 强制更新现有缓存

部署新版本后，用户浏览器中的旧Service Worker可能仍保留着错误缓存的文件，需要触发Service Worker更新：

• 修改service-worker.js中的缓存名称（例如将const CACHE_NAME = 'app-cache-v1'改为v2）；
• 或者在项目发布时添加版本号标识，确保浏览器识别到资源更新。

4. 版本兼容性检查

如果上述配置不生效，确认你使用的是.NET 6或更高版本的SDK——Blazor WASM的懒加载与PWA集成在.NET 6及以上版本中才完成了完善支持，旧版本可能存在逻辑漏洞。

补充说明 #

你手动清除缓存后能正常按需加载懒加载模块，说明应用本身的懒加载逻辑是正常的，问题仅出在Service Worker的预缓存规则上。通过调整.csproj的配置，就能让懒加载模块按照预期在需要时才从服务器下载，而不是被预缓存。

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