Google Cloud Storage认证URL与公共URL返回图片不一致问题

问题根因 #

• GCS 公共URL默认使用全球CDN缓存，未显式配置Cache-Control的公共对象默认缓存时长为3600秒（1小时）。当你覆盖/删除重传同名Blob时，CDN边缘节点仍然存储旧版本的资源副本，会持续返回旧内容直到缓存过期，这就是为什么一段时间后两个URL内容会自动同步。
• 认证URL不会走公共CDN缓存，每次请求都会直接回源拉取最新的Blob内容，所以永远显示最新上传的正确图片。
• 你排查时排除的是本地缓存，而问题出在GCS的全局CDN缓存层，所以其他用户访问公共URL也会看到旧内容。
• 删除旧Blob再传新同名Blob的操作只会修改源站存储，不会主动触发CDN缓存清理，所以还是会出现该问题。

修复方案 #

1. 上传时显式配置缓存策略（优先推荐）

修改上传代码，在上传文件时指定Cache-Control头，缩短缓存时长或者禁用缓存：

def upload_to_cloud(blob_name, file_obj):
    file_type = imghdr.what(file_obj)
    blob_name = str(blob_name) + '.' + file_type
    stats = storage.Blob(bucket=bucket, name=blob_name).exists(client)
    if stats is True:
        storage.Blob(bucket=bucket, name=blob_name).delete()
    blob = bucket.blob(blob_name)
    blob.upload_from_file(
        file_obj=file_obj, 
        content_type=f'image/{file_type}',
        # 新增缓存控制配置：缓存60秒，过期必须回源校验
        cache_control='public, max-age=60, must-revalidate'
    )
    path = blob.public_url
    return path

如果对内容一致性要求极高，可以把max-age设为0，完全禁用CDN缓存。

2. 主动清理CDN缓存（适合紧急修复）

如果上传后需要立刻让所有用户看到新内容，可以调用GCS的CDN缓存清理接口，对对应Blob的公共URL执行purge操作，注意该操作有配额限制，不建议高频调用。

3. 文件名加版本戳（最稳妥方案）

如果业务允许修改URL规则，每次上传新文件时给Blob名加唯一版本标识（比如时间戳、文件哈希值），示例：

import time
# 拼接文件名时增加时间戳后缀
blob_name = f"{str(blob_name)}_{int(time.time())}.{file_type}"

该方案完全避免了同名文件的缓存冲突问题，不需要依赖缓存策略配置，适合核心业务资源的存储。

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