如何让浏览器检查HTTP API返回的PDF新版本且避免重复下载？

要实现这个需求，核心是利用HTTP的缓存协商机制，让浏览器自动验证服务器上的文件状态，只有当文件更新时才下载，否则返回304状态码复用本地缓存。以下是具体实现步骤：

客户端侧处理（无需额外编码） #

浏览器本身就支持缓存协商逻辑，只要服务器配置正确：

• 首次请求PDF时，浏览器会缓存文件内容及服务器返回的缓存标识头（ETag/Last-Modified）
• 后续再次请求同一URL时，浏览器会自动在请求头中携带If-None-Match（对应ETag）或If-Modified-Since（对应Last-Modified），向服务器验证文件是否更新
• 如果你用前端框架的<embed>、<iframe>或类似组件展示PDF，只要保持URL不变，就会自动触发上述逻辑，不需要手动添加时间戳或版本号到URL（那样会绕过缓存协商，反而浪费带宽）

服务器侧核心配置（关键） #

你需要在返回PDF的API中配置以下响应头，并处理客户端的条件请求：

1. 生成并返回ETag头
   ETag是文件的唯一标识（通常用文件内容的哈希值，比如MD5、SHA-256），文件内容更新时哈希值会自动变化。示例响应头：

   ETag: "a1b2c3d4e5f6"
   

2. 返回Last-Modified头
   用PDF文件在服务器上的最后修改时间作为值，格式必须符合HTTP标准（GMT格式）。示例响应头：

   Last-Modified: Fri, 20 Oct 2023 08:30:00 GMT
   

3. 处理条件请求，返回304状态码

   • 当客户端请求头携带If-None-Match时，对比当前文件的ETag：如果一致，返回304 Not Modified，不返回文件内容
   • 当客户端请求头携带If-Modified-Since时，对比文件的最后修改时间：如果文件未更新，返回304 Not Modified

4. 设置合理的Cache-Control头
   不要用no-cache（强制重新下载），而是配置成让浏览器必须向服务器验证缓存有效性：

   Cache-Control: max-age=0, must-revalidate
   

   这个配置的意思是：缓存立即过期，每次请求必须先向服务器验证文件是否更新。

额外注意事项 #

• 不要在PDF的URL中添加随机参数（比如?t=123456），除非你需要强制用户刷新一次；这种做法会让浏览器把每次请求都当成新资源，完全失去缓存协商的作用
• 如果你的前端框架有自定义缓存逻辑，要确保它不会覆盖浏览器的原生HTTP缓存机制
• 可以用浏览器开发者工具的Network面板验证：查看请求头是否携带If-None-Match/If-Modified-Since，以及响应状态码是否为304（文件未更新时）

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