图片加载慢、流量费用偏高,或者文件明明替换了,页面却还显示旧内容,都可能和缓存有关。阿里云 OSS 缓存不是一个单独的开关:对象可以带缓存响应头,浏览器据此决定是否保存文件;接入 CDN 后,边缘节点也可以缓存 OSS 上的内容。设置前先确认请求经过哪些缓存层,再按文件的更新频率确定缓存时间。
先分清 OSS、浏览器和 CDN 的缓存
OSS 负责存储和分发对象。上传文件时,可以设置 Cache-Control、Expires、ETag、Last-Modified 等响应头。浏览器收到后,会据此判断是否在本地保存文件,以及再次访问时是否需要向服务器验证。
如果域名接入了 CDN,用户请求通常会先到 CDN 节点。节点有缓存就直接返回;没有缓存时,再向 OSS 回源获取。浏览器和 CDN 是两层缓存,规则可以不同。只修改 OSS 对象的响应头,不一定能改变 CDN 的缓存行为,还要核对 CDN 缓存规则、回源配置和缓存键。
简单说,浏览器缓存可以减少同一用户重复下载,CDN 缓存可以减少不同用户重复回源,OSS 保存源文件。排查时先看实际访问的是 OSS 域名还是 CDN 加速域名,再检查对应的响应头和缓存规则。
缓存头怎么选:看文件多久会变
Cache-Control 是常用的缓存控制响应头。例如 Cache-Control: public, max-age=86400 表示允许公共缓存,缓存新鲜期为一天。时间要结合文件更新频率设置,不能简单地认为越长越好。
- 带版本号的静态文件:例如
app.8f31a.js、logo-v3.png。内容更新时更换文件名,页面再引用新地址,旧缓存就不会挡住新版。此类资源可以设置较长缓存,例如一年;使用 CDN 时,也要确认节点缓存时长与版本命名方式相符。 - 文件名固定、内容可能替换的资源:例如
banner.jpg。可以设较短缓存,或者每次替换后刷新 CDN。若缓存时间很长,只覆盖 OSS 上的同名文件,用户仍可能看到旧图。 - 私人或敏感文件:例如用户账单和个人资料。不能因为接入了 CDN,就把文件当作公开资源缓存。应配合访问权限和签名 URL 控制访问,并谨慎设置公共缓存;需要时可使用
Cache-Control: private或no-store。
ETag 和 Last-Modified 用于校验资源。缓存过期后,浏览器可以带上校验信息询问文件是否变化;文件未变时,服务端可返回未修改状态,避免重新传输完整内容。校验头能减少重复传输,但不能替代合适的缓存时长。
阿里云 OSS 缓存的设置步骤
- 确认访问方式。先看业务直接使用 OSS 域名,还是通过自定义域名和 CDN 访问。若要提升多地用户的下载速度、减少回源请求,需要检查 CDN 是否接入正确;只改 OSS 对象属性,未必能达到预期效果。
- 按文件用途分规则。图片、字体、脚本和下载文件可以分别设置缓存策略。带版本号的文件与固定文件名的文件要分开处理,避免所有对象都套用超长缓存。
- 设置对象响应头。可以在 OSS 控制台的对象属性中检查或修改 HTTP 响应头,也可以通过 SDK 或工具在上传时设置元数据。批量修改前确认操作范围;有些情况下新上传的文件已使用新规则,旧对象仍保留原设置。
- 核对 CDN 配置。确认加速域名指向正确的 OSS 回源地址,并检查缓存时长、缓存规则和查询字符串处理方式。若不同查询参数会返回不同内容,就不能随意从缓存键中忽略参数,否则可能返回不对应的文件。
- 用实际请求验证。通过浏览器开发者工具或命令行查看响应头,关注
Cache-Control、Age、ETag等信息,并比较首次请求和重复请求。控制台显示的配置不等于用户最终收到的结果,仍要以实际访问响应为准。
同名海报替换后,为什么页面还是旧图
假设电商团队把活动海报存放在 OSS,通过 CDN 分发,文件名一直是 spring-sale.jpg。为了减少加载和回源,图片设置了较长缓存。活动临近时,团队直接用新图覆盖旧文件,但部分用户打开页面仍看到旧海报。
这时先确认 OSS 上的文件已经更新,再检查 CDN 是否还保留旧副本,并按需刷新对应 URL。刷新 CDN 可以让节点重新获取源文件,但已经保存在用户浏览器里的副本不一定会马上消失。若只刷新 CDN,却不考虑浏览器缓存,问题仍可能在部分用户那里出现。
更稳妥的做法是把文件名改为 spring-sale-2025.jpg,并同步更新页面引用。带版本号的静态资源可以设置较长缓存;必须沿用固定文件名的临时素材,则缩短缓存时间,并在更新后按需刷新 CDN。这样既能保留常规资源的缓存效果,也能降低活动内容更新不及时的风险。
设置时容易漏掉的几件事
- 只修改 OSS,不检查 CDN:CDN 可能仍按自己的规则缓存,最终响应和对象上的响应头不一定一致。
- 覆盖同名文件后只刷新 CDN:刷新处理的是 CDN 节点缓存,不能清除每个用户浏览器已经保存的副本。长期使用的静态资源,优先考虑版本化文件名。
- 所有对象都设为 public:公共缓存适合公开的静态文件,不适合包含个人信息或因用户权限而返回不同内容的对象。缓存设置要和访问控制一起检查。
- 把跨域问题当成缓存问题:前端跨域请求还会受到 CORS 配置影响。遇到资源无法加载时,分别查看请求状态、响应头和跨域报错,不要只改缓存时长。
按更新方式设置阿里云 OSS 缓存
带版本号的静态资源适合长缓存;文件名固定、经常替换的内容,适合缩短缓存或在更新后刷新 CDN;私人文件则要先处理访问权限和隐私要求。配置完成后,从实际使用的域名检查响应头,并分别验证浏览器和 CDN 的表现。缓存时间设得合适,才能兼顾加载速度、回源请求和内容更新。