Flutter web项目执行firebase deploy部署后新版本未更新如何解决

• 第一步：验证 Firebase 配置路径是否正确
  打开项目根目录下的firebase.json文件，检查hosting.public字段是否指向 Flutter 构建产物的输出目录，正确配置示例如下：

{
  "hosting": {
    "public": "build/web",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ]
  }
}

如果路径配置错误，修改后重新执行构建、部署流程即可。

• 第二步：排查浏览器缓存问题
  Flutter Web 部署后默认会被浏览器缓存旧版本资源，可通过以下方式验证是否为缓存问题：
  1. 按Ctrl+F5（Windows）/Cmd+Shift+R（Mac）强制刷新页面
  2. 用浏览器无痕模式访问站点
     如果强制刷新后显示新版本，可在firebase.json中添加缓存规则避免后续更新出现缓存问题，规则示例：

{
  "hosting": {
    "public": "build/web",
    "headers": [
      {
        "source": "**/*.html",
        "headers": [
          {
            "key": "Cache-Control",
            "value": "no-cache"
          }
        ]
      },
      {
        "source": "**/*.@(js|css|png|jpg|svg)",
        "headers": [
          {
            "key": "Cache-Control",
            "value": "max-age=31536000"
          }
        ]
      }
    ]
  }
}

• 第三步：确认构建流程完整性
  执行完整构建流程再部署，命令如下：

flutter clean
flutter pub get
flutter build web --release
firebase deploy

如果你的项目配置了多环境、自定义web渲染器，可按需在flutter build web后添加对应参数。

• 第四步：确认部署目标是否正确
  如果你在 Firebase 中配置了多个 Hosting 站点，需要在部署命令中指定目标站点，避免部署到错误站点：

firebase deploy --only hosting:你的站点名称

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