适用范围与准备
适用于用curl -z或--time-cond避免重复下载,但每次仍收到完整文件,或本地没有新正文的情况。先保留可信原文件;本篇处理HTTP修改时间条件,不处理ETag配对或断点续传。
先区分原因
--time-cond接受时间表达式,也可读取本地文件的修改时间。指定的文件不存在时,curl会继续不带时间条件的传输;默认会给出警告,但-s或--silent会隐藏这类警告。有条件也不保证服务器一定返回304。文件下载时间、手工修改时间与服务器Last-Modified不能任意混用。
按顺序操作
- 确认-z后的值是明确时间还是确实存在的本地文件路径,留意curl的标准错误输出。检查当前工作目录,避免相对路径指向不存在的文件。
- 将原文件只读保留,下载结果写到另一个临时路径,并单独保存响应头。不要把条件参照文件同时作为本轮未验收的输出文件。
- 对同一公开资源只做一次带条件请求,记录HTTP状态、Last-Modified及是否收到正文。示例中cached.body必须事先存在且对应这个资源。
- 收到304时保留原来的可用正文,不把空输出替换进去;收到200时检查新正文和可信摘要,再决定替换。200可能表示资源变化或条件未被采用,不能立即认定curl选项失效。
- 需要再次验证时,先核对服务器修改时间、原文件mtime与资源身份是否一致。若服务提供ETag,可转到已有ETag教程,不把两种验证标记随意拼成同一文件。
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当作下载了新内容。