如何禁用通过 IIS 提供的单页应用程序 HTML 文件的缓存？

Question

我有一个通过 IIS 提供服务的单页应用程序 (angular-js)。如何防止缓存 HTML 文件？该解决方案需要通过更改 index.html 或 web.config 中的内容来实现，因为无法通过管理控制台访问 IIS。

我目前正在研究的一些选项是：

• web.config 缓存配置文件 - http://www.iis.net/configreference/system.webserver/caching
• web.config 客户端缓存 - http://www.iis.net/configreference/system.webserver/staticcontent/clientcache
• 元标签 - Using <meta> tags to turn off caching in all browsers?

IIS 是 .NET 框架 4 的 7.5 版

Answer 1

在提供您的 html 文件时，您可以附加一个随机查询字符串。即使文件在浏览器缓存中，这也会阻止浏览器使用旧版本。

/index.html?rnd=timestamp

另一个选项是在 IIS 级别添加无缓存设置。这会在响应中添加 Cache-Control: no-cache，告诉浏览器不要缓存文件。它从 IIS 7 开始工作。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <!-- Note the use of the 'location' tag to specify which 
       folder this applies to-->
  <location path="index.html">
    <system.webServer>
      <staticContent>
        <clientCache cacheControlMode="DisableCache" />
      </staticContent>
    </system.webServer>
  </location>
</configuration>

Answer 2

将以下内容添加到 web.config 解决方案中适用于 Chrome、IE、Firefox 和 Safari：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>

  <location path="index.html">
    <system.webServer>
      <httpProtocol>
        <customHeaders>
          <add name="Cache-Control" value="no-cache" />
        </customHeaders>
      </httpProtocol>
    </system.webServer>
  </location>

</configuration>

这将确保在请求 index.html 时将 Cache-Control 标头设置为 no-cache。

Answer 3

对于 .NET Core，我使用了以下内容。

        app.UseStaticFiles(new StaticFileOptions
        {
            OnPrepareResponse = context =>
            {                   
                if (context.File.Name == "index.html" ) {
                    context.Context.Response.Headers.Add("Cache-Control", "no-cache, no-store");
                    context.Context.Response.Headers.Add("Expires", "-1");
                }
            }
        });

感谢How to disable browser cache in ASP.NET core rc2?

Answer 4

  <meta http-equiv="cache-control" content="no-cache, must-revalidate, post-check=0, pre-check=0">

Answer 5

SPA 的主要前提是从不缓存 index.html

在MDN recommendations to prevent caching 之后，我们必须添加 Cache-Control HTTP 标头和 no-store, max-age=0 资源的值（在我们的例子中是 index.html 文件）。

为什么 no-store 而不是 no-cache？

使用 no-store，资源不会存储在任何地方。使用no-cache，资源可能会被存储，但在使用前需要通过存储与服务器进行验证。

为什么max-age=0？

强制清除预先存在的有效缓存响应（no-store 不会）。

在 IIS 中，我们可以通过 web.config 文件管理我们的应用缓存配置。这是一个完整的 web.config 文件（必须位于我们应用程序的根目录中），其中包括 index.html 文件的缓存配置以及路由配置（我已经添加了 SPA 路由和 HTTP 重定向到 HTTPS 作为示例）：

<configuration>
  <location path="index.html">
    <system.webServer>
      <httpProtocol>
        <customHeaders>
          <add name="Cache-Control" value="no-store, max-age=0" />
        </customHeaders>
      </httpProtocol>
    </system.webServer>
  </location>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="HTTP to HTTPS" enabled="true" stopProcessing="true">
          <match url="(.*)" />
          <conditions>
            <add input="{HTTPS}" pattern="^OFF$" />
          </conditions>
          <action type="Redirect" url="https://{HTTP_HOST}{REQUEST_URI}" />
        </rule>
        <rule name="SPA Routes" enabled="true" 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>

Answer 6

这些答案都不适合我，因为正如@MichailMichailidis 所提到的，“SPA 中的所有请求都有虚拟 url，并且不映射到真实的位置路径”，所以 location path从不匹配index.html。

我在这个blog post 中找到了解决方案，它链接到this answer。两者都向您展示了如何使用重写模块的outboundRules 根据条件更改cache-control 响应标头。

所以这就是我的 web.config 在这个配置之后的样子：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <outboundRules>
        <rule name="RewriteCacheControlForIndexHtmlFile" 
          preCondition="IsIndexHtmlFile">
          <match serverVariable="RESPONSE_Cache_Control" pattern=".*" />
          <action type="Rewrite" value="max-age=0" />
        </rule>
        <preConditions>
          <preCondition name="IsIndexHtmlFile">
            <add input="{REQUEST_FILENAME}" pattern="index.html" />
          </preCondition>
        </preConditions>
      </outboundRules>
...