Azure部署的Flask应用：更新后的index.html在浏览器不显示求助

以下是几个可行的解决方向：

• 强制浏览器刷新本地缓存
  直接使用快捷键强制刷新页面：Windows/Linux按Ctrl + Shift + R，Mac按Cmd + Shift + R，这会跳过浏览器本地缓存，直接从服务器拉取最新的index.html内容。

• 禁用Flask的模板缓存
  Flask在生产环境默认会缓存模板文件，修改app.py添加配置禁用缓存：

  from flask import Flask
  app = Flask(__name__)
  
  # 开启模板自动重载，修改模板后无需重启应用即可生效
  app.config['TEMPLATES_AUTO_RELOAD'] = True
  

  部署更新后的app.py即可让Flask每次请求都重新加载最新的模板文件。

• 配置Azure Web App的缓存策略
  通过配置文件限制Azure服务器对HTML文件的缓存时长：

  • 若使用Windows主机，在项目根目录创建web.config文件，添加以下内容：

    <configuration>
      <system.webServer>
        <staticContent>
          <!-- 对HTML文件禁用缓存 -->
          <clientCache cacheControlMode="DisableCache" />
        </staticContent>
      </system.webServer>
    </configuration>
    

  • 若使用Linux主机，在项目根目录创建.htaccess文件，添加：

    <FilesMatch "\.(html)$">
      Header set Cache-Control "no-cache, no-store, must-revalidate"
      Header set Pragma "no-cache"
      Header set Expires 0
    </FilesMatch>
    

  部署该配置文件后，Azure会在响应头中设置缓存规则，避免浏览器长期缓存旧文件。

• 清除Azure服务器端缓存
  登录Azure门户，进入你的Web App，打开「高级工具」（即Kudu工具），进入「Debug console」选择「CMD」，导航到site/wwwroot/templates目录，确认最新的index.html已存在，同时可以删除目录下可能存在的临时缓存文件；也可以在Kudu的「Process explorer」中重启Python进程，确保应用加载最新文件。

• 添加版本标识（长期解决方案）
  给模板或关联的静态资源添加版本参数，每次更新时修改版本号，强制浏览器加载新内容。比如在页面引用资源时添加：

  <!-- 示例：给静态CSS添加版本号 -->
  <link rel="stylesheet" href="{{ url_for('static', filename='style.css?v=2.1') }}">
  

  对于模板本身，也可以考虑在发布新版本时修改文件名（如index_v2.html），并同步更新app.py中的渲染路径，彻底避免缓存冲突。

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