适用范围与准备

适用于用curl -z或--time-cond避免重复下载,但每次仍收到完整文件,或本地没有新正文的情况。先保留可信原文件;本篇处理HTTP修改时间条件,不处理ETag配对或断点续传。

先区分原因

--time-cond接受时间表达式,也可读取本地文件的修改时间。指定的文件不存在时,curl会继续不带时间条件的传输;默认会给出警告,但-s或--silent会隐藏这类警告。有条件也不保证服务器一定返回304。文件下载时间、手工修改时间与服务器Last-Modified不能任意混用。

按顺序操作

  1. 确认-z后的值是明确时间还是确实存在的本地文件路径,留意curl的标准错误输出。检查当前工作目录,避免相对路径指向不存在的文件。
  2. 将原文件只读保留,下载结果写到另一个临时路径,并单独保存响应头。不要把条件参照文件同时作为本轮未验收的输出文件。
  3. 对同一公开资源只做一次带条件请求,记录HTTP状态、Last-Modified及是否收到正文。示例中cached.body必须事先存在且对应这个资源。
  4. 收到304时保留原来的可用正文,不把空输出替换进去;收到200时检查新正文和可信摘要,再决定替换。200可能表示资源变化或条件未被采用,不能立即认定curl选项失效。
  5. 需要再次验证时,先核对服务器修改时间、原文件mtime与资源身份是否一致。若服务提供ETag,可转到已有ETag教程,不把两种验证标记随意拼成同一文件。
macOS / Linux shell;域名为占位,替换为有权访问的测试目标;无需管理员权限
curl -q --time-cond cached.body --dump-header conditional.headers --output candidate.body --connect-timeout 10 --max-time 20 "https://example.com/resource"
观察项含义与下一步
参照文件不存在按无时间条件传输;静默模式可能不显示警告
HTTP 304继续使用已有正文
HTTP 200独立验证新正文,再替换

怎样确认有效

请求条件来自正确的本地资源,状态与正文处理一致,旧文件在未取得有效替代前仍可用,才算安全完成条件下载。缺失参照文件时应按条件未生效处理;静默模式下没有警告也不能证明条件已发送。

无效时恢复与下一步

保留原件并删除或隔离本轮未验收的临时输出。若无法确定参照时间,使用一次普通下载到新文件重新建立基线,不伪造mtime,也不把304当作下载了新内容。