aria2下载中断后如何续传？

Question

**问题：** aria2下载中断后无法续传，提示“416 Requested Range Not Satisfiable”或直接重新开始下载，即使已存在部分完成的`.aria2`控制文件和临时文件（如`xxx.zip.aria2`和`xxx.zip`）。常见原因包括：服务器不支持HTTP Range请求（如某些CDN或静态资源站禁用断点续传）、本地文件被手动修改/删除、`.aria2`元数据损坏、或未启用`--continue=true`（虽为默认值，但在脚本中被显式覆盖）。此外，使用`--allow-overwrite=false`且目标文件已存在但大小不匹配时，aria2可能拒绝续传而非校验分块。如何准确判断续传可行性，并安全恢复下载而不重复拉取已有数据？

Answer 1

```html

一、现象层：识别续传失败的典型症状与日志线索

当 aria2 中断后执行 aria2c -C xxx.zip 或重复调用原命令，若出现以下任一现象，则表明续传机制未生效：

• 416 Requested Range Not Satisfiable HTTP 响应（服务端明确拒绝分块请求）
• 日志中出现 Download aborted. Removing download result. 后重建临时文件
• 目标文件 xxx.zip 被清空或截断，xxx.zip.aria2 元数据被重写
• 实际网络流量从 0 Byte 开始重新拉取（可通过 iftop 或 aria2c --summary-interval=1 验证）

二、协议层：HTTP Range 支持性验证与服务器行为测绘

续传依赖服务端对 Range: bytes=0- 和 Range: bytes=12345- 的正确响应。需执行如下诊断：

curl -I -H "Range: bytes=0-99" https://example.com/xxx.zip
# ✅ 正确响应：HTTP/2 206 Partial Content + Content-Range header
# ❌ 失败响应：HTTP/2 200 OK（无 Content-Range）、416、403、或 Connection: close

对 CDN（如 Cloudflare、Akamai）或对象存储（如 OSS、S3 默认静态托管）需特别注意：部分配置会禁用 Accept-Ranges 响应头，即使支持 206 也可能因缓存策略导致不一致。

三、元数据层：.aria2 文件完整性与状态映射分析

.aria2 是二进制控制文件，不可直接编辑，但可通过 aria2c --show-console-readout=true 启动时观察其加载状态。关键校验点如下表：

字段	作用	损坏表现
fileLength	服务端声明的总大小（来自首次 HEAD）	与当前 xxx.zip 实际大小严重偏差
completedLength	已成功下载字节数（持久化于 .aria2）	为 0 或远小于 ls -l xxx.zip 结果

四、策略层：安全续传的决策树与前置检查流程

以下 Mermaid 流程图定义了是否可安全续传的自动化判断逻辑：

flowchart TD
  A[存在 xxx.zip 和 xxx.zip.aria2？] -->|否| B[必须全新下载]
  A -->|是| C[校验 xxx.zip 大小 ≥ completedLength？]
  C -->|否| D[文件被篡改/截断 → 拒绝续传]
  C -->|是| E[发起 HEAD 请求获取 Content-Length & Accept-Ranges]
  E -->|无 Accept-Ranges 或 200 非 206| F[服务端不支持 Range → 强制 --continue=false]
  E -->|返回 206 或 Accept-Ranges: bytes| G[执行 range probe：GET bytes=completedLength-completedLength+1]
  G -->|206 + 1-byte 响应| H[✅ 可安全续传：aria2c -C --allow-overwrite=true xxx.zip]
  G -->|416| I[⚠️ 服务端声称长度变更 → 需人工确认是否版本更新]

五、工程层：生产环境高可靠性续传方案

在 CI/CD 或批量下载系统中，推荐组合使用以下加固策略：

1. 启用 --auto-file-renaming=false --allow-overwrite=true 避免文件名冲突导致元数据错位
2. 添加 --check-certificate=true --http-accept-gzip=true 防止 TLS 握手异常中断
3. 使用 --bt-enable-lpd=true --seed-ratio=0.0 对 BT 类任务规避 tracker 不一致问题
4. 对关键任务部署 aria2c --save-session-on-download-error=true 并定期归档 .aria2

当检测到 416 时，不应简单重试，而应触发降级逻辑：先 mv xxx.zip xxx.zip.partial，再以 --max-tries=1 --retry-wait=0 获取新 HEAD，比对 Content-Length 变更后再决定是否丢弃旧状态。

```