IIS部署的Blazor Wasm应用出现随机404及连接超时问题求助

1. 排查DNS解析与缓存问题 #

• 既然修改hosts能解决，优先排查公司内部DNS服务器的解析稳定性：让出现问题的用户用nslookup或dig命令查询站点域名，对比正常用户的解析结果，确认是否存在间歇性解析失败或针对部分客户端IP返回错误地址的情况。
• 清理客户端DNS缓存：Windows用户执行ipconfig /flushdns，Mac用户执行sudo dscacheutil -flushcache，观察是否能临时解决问题；同时检查DNS服务器的TTL设置，避免过长导致解析变更无法及时同步到客户端。
• 清空服务器端DNS缓存：在IIS服务器上执行dnscmd /clearcache或重启DNS服务，排查服务器端缓存异常的可能。

2. 检查IIS与应用池配置 #

• 调整应用池回收规则：如果应用池设置了定时回收，可临时关闭自动回收或调整到低峰期执行，同时查看应用池日志，确认回收过程中是否有错误记录。
• 优化静态文件缓存策略：Blazor Wasm生成的.dll.js、.blazor.boot.json等静态资源若缓存配置不合理，可能导致客户端缓存过期路径引发404。可在web.config中添加缓存控制：

  <staticContent>
    <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="00:05:00" />
  </staticContent>
  

• 调整请求队列限制：在IIS站点“高级设置”中，调高“最大并发连接数”和“请求队列限制”，同时监控服务器CPU、内存使用率，排查资源瓶颈导致的超时问题。

3. Blazor Wasm专项排查 #

• 验证路由与Bootstrap配置：检查index.html中_framework/blazor.webassembly.js路径是否正确；在测试环境的Program.cs中启用路由调试，排查路由匹配异常：

  builder.Services.AddRazorPages().AddRazorPagesOptions(options =>
  {
      options.Conventions.AddPageRoute("/", "");
  });
  

• 排查Service Worker异常：让用户在浏览器开发者工具的Application>Service Workers中注销缓存，同时检查wwwroot/service-worker.js和service-worker-assets.js的配置是否存在错误。
• 开启Blazor调试日志：在index.html中添加日志配置，让出现问题的用户收集控制台错误信息：

  <script>
      Blazor.start({ logLevel: 2 });
  </script>
  

4. 网络层排查 #

• 绕过域名直接访问：让出现问题的用户用服务器IP直接访问站点，排查防火墙或代理服务器是否拦截域名请求。
• 跟踪网络路径：用tracert（Windows）或mtr（Mac/Linux）命令跟踪用户到服务器的网络链路，排查是否存在丢包、延迟过高的节点。

5. 日志分析 #

• 开启IIS详细错误日志：设置日志格式为W3C，记录请求状态码、客户端IP、请求路径等信息，筛选异常请求分析规律。
• 查看系统事件日志：在Windows事件查看器中检查“应用程序日志”和“系统日志”，排查IIS应用池崩溃、资源不足等异常记录。

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