如何修复站点功能缓存问题？GCP存储桶更新后站点访问异常

可以通过调整Google Cloud Storage（GCS）的缓存配置解决该问题。
核心原因是站点入口HTML文件（通常为index.html）被浏览器长期缓存，新版本发布后用户加载的还是旧版本入口文件，其引用的旧版本静态资源已被替换删除，因此出现全站点功能异常

1. 优先调整入口HTML文件的缓存策略 #

• 仅对根目录下的入口HTML文件设置无缓存规则，其他带哈希后缀的静态资源（js、css、图片等）保留长期缓存即可，不会影响站点加载性能
• 入口文件的Cache-Control值统一设置为no-store, max-age=0，强制浏览器每次访问都向GCS请求最新版本的入口文件

2. 上传构建包时主动配置缓存头（推荐方案） #

你可以直接在gsutil上传命令中指定不同文件的缓存规则，避免手动修改存储桶配置的重复操作，示例命令如下：

# 第一步：上传所有构建产物，默认设置静态资源长期缓存
gsutil -m cp -r ./本地构建产物目录/* gs://你的存储桶名称/
# 第二步：单独覆盖入口HTML文件的缓存规则
gsutil setmeta -h "Cache-Control:no-store, max-age=0" gs://你的存储桶名称/index.html

3. 存储桶层面配置默认缓存规则 #

如果需要固定存储桶的缓存规则，减少上传时的命令参数，可按以下步骤配置：

• 进入GCP控制台的Cloud Storage页面，打开对应存储桶的「配置」标签
• 找到「默认对象元数据」板块，添加默认元数据：键为Cache-Control，值为public, max-age=31536000，作为所有非特殊文件的默认缓存策略
• 上传入口HTML文件时，仍然需要单独执行上述setmeta命令覆盖其缓存规则

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