在.NET Blazor项目中更换页面图标遇到加载问题

• 检查Service Worker缓存（针对Blazor PWA项目）
  Blazor PWA会通过service-worker.js缓存静态资源，就算清了浏览器缓存，Service Worker可能还存着旧图标。操作步骤：打开浏览器开发者工具→Application→Service Workers，点击"Unregister"，然后重启项目。另外要检查wwwroot/service-worker-assets.js，确认里面的favicon.ico哈希值对应新图标，若不对，重新运行dotnet publish生成该文件。

• 强制浏览器硬刷新
  普通刷新可能绕不开缓存，直接用快捷键：Windows/Linux按Ctrl+Shift+R，Mac按Cmd+Shift+R，强制浏览器重新加载所有资源。

• 给图标URL加版本参数
  在index.html的图标引用里加版本号，比如：

  <link rel="icon" type="image/x-icon" href="favicon.ico?v=2.0">
  

  每次更换图标时更新版本号，强制浏览器识别为新资源，避免使用缓存。

• 清理项目构建缓存
  删除项目下的bin和obj文件夹，然后执行dotnet clean，再重新构建项目。有时候构建缓存会残留旧的图标文件，导致替换不生效。

• 检查Server端静态资源缓存策略（Blazor Server项目）
  如果是Blazor Server，可能Server端设置了过长的静态资源缓存时间。在Program.cs里调整静态资源配置，临时禁用缓存调试：

  app.UseStaticFiles(new StaticFileOptions
  {
      OnPrepareResponse = ctx =>
      {
          ctx.Context.Response.Headers.Append("Cache-Control", "no-cache, no-store, must-revalidate");
          ctx.Context.Response.Headers.Append("Expires", "0");
      }
  });
  

  发布时再调整为合适的缓存策略。

• 清除浏览器站点级缓存
  有些浏览器会单独缓存网站图标，可在浏览器设置的"Site Settings"里找到本地项目对应的站点，清除其缓存数据；或者直接清除浏览器所有时间范围的缓存。

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