发布至IIS的.NET7 Blazor WASM应用API调用异常：仅首次有效需强制刷新

可能原因及解决方法 #

1. 静态资源缓存策略问题 #

Blazor WASM的核心静态文件（如blazor.boot.json、_framework目录下的文件）被浏览器过度缓存，导致客户端逻辑未正确更新。解决步骤：

• 在IIS中配置站点HTTP响应头，添加针对性缓存规则：
  • 对_framework/*、blazor.boot.json设置Cache-Control: no-cache, no-store, must-revalidate
  • 对CSS、图片等普通静态资源设置合理过期时间，比如Cache-Control: public, max-age=86400
• 或在项目wwwroot目录下添加web.config，配置静态文件缓存与路由规则：

  <configuration>
    <system.webServer>
      <staticContent>
        <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="00:00:00" />
        <remove fileExtension=".json" />
        <mimeMap fileExtension=".json" mimeType="application/json" />
      </staticContent>
      <rewrite>
        <rules>
          <rule name="Blazor Routes" stopProcessing="true">
            <match url=".*" />
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
              <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
            </conditions>
            <action type="Rewrite" url="index.html" />
          </rule>
        </rules>
      </rewrite>
    </system.webServer>
  </configuration>
  

2. HttpClient与服务生命周期问题 #

检查服务层（如UtilityService）的实现细节：

• 确保HttpClient是通过构造函数注入，而非静态字段或单例持有
• 确认UtilityService的注册确实是AddScoped，而非误设为AddSingleton——单例服务持有的HttpClient会因连接复用问题导致请求失效

3. IIS输出缓存干扰 #

IIS可能对API响应进行了缓存，导致后续请求直接返回缓存内容而非命中后端：

• 打开IIS管理器，找到站点的输出缓存功能，禁用针对/api/*路径的缓存规则
• 在API控制器的Action上添加特性[ResponseCache(NoStore = true, Location = ResponseCacheLocation.None)]，强制禁止响应缓存

4. Blazor组件触发逻辑问题 #

检查Razor组件中API调用的触发时机：

• 确保API调用在OnInitializedAsync或OnParametersSetAsync中执行，而非仅在组件首次加载时触发
• 若使用了状态管理（如Blazor State），确认状态更新后是否正确触发了组件重新渲染与API调用

5. 浏览器缓存验证 #

• 在开发者工具「网络」标签勾选「禁用缓存」，正常操作站点验证是否能多次触发API调用
• 查看API请求的响应头，确认是否包含Cache-Control、Expires等缓存字段，判断是否是缓存导致请求未发送

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