实务专题 · 交付验收

公开资料换新版,要先约定缓存版本

在同一个长期缓存地址后面替换宣传册,客户可能仍看到旧文件。发布新版前,应约定版本化素材地址,或经审核的重新验证与清理策略。上传成功不证明所有中间层与设备都已拿到新字节。

适用读者与交付决定

更新公开目录及品牌素材的企业。把本题作为网站供应方的有限验收任务;实际系统证据不能由教学例子替代。

官方依据与解释边界

HTTP缓存指南介绍版本化地址及新鲜度、重新验证机制;地址变化不证明每个入口都已更新。 MDN: HTTP caching · 核对日期:2026年10月16日。

已填写教学例子

合成例子,不是真实客户案例。 列出有限输入、预期结果及反例,不代表已完成真实平台集成。

窄屏可横向滚动表格。

输入/情况检查口径预期结果
oldURL=v1, newURL=v2; hash changes新身份版本化候选
same URL; hash changes地址复用审核缓存策略
new URL; same hash内容相同无内容差额

怎样执行验收

  1. 记录批准文件hash、公开地址及缓存策略。
  2. 测试普通重复访问,核对真实响应字节,不只看文件名。
  3. 核对本次获准发布入口,保留旧证据并记录回退。

如何解释结果与保留证据

例子只比较地址与hash,不清理CDN。新身份只是发布策略候选,不保证瞬时传播。验收还需真实响应头及下载hash。私有账号内容能否存储,与公开素材是否新鲜是两个问题。

适用边界

不改旧素材地址、缓存头或网站依赖;不覆盖Service Worker更新和自动清理。

离线复核

把下方两份文件存入同一目录,以Node22.13或更新版本运行。示例不联网、不修改任何账号或网站。 已填输入与预期输出 · 可检查的函数

node decision-check.mjs public-asset-version-contract.json