JHenTai 中文文档 下载 App

下载任务卡在某一步不动

现象分类

下载卡住通常有以下几种表现:

1. 速度为 0,进度条不动

最常见。排查步骤:

  1. 检查网络:画廊列表能否正常加载?如果整个应用都无法刷新,是网络断了或代理失效
  2. 检查代理:如果使用代理,确认代理服务器在运行且能访问 EH
  3. 暂停 / 继续:在下载管理页手动暂停再继续任务,触发 EHExecutor 重新调度
  4. 降低并发数:设置 → 下载 → 把下载并发数从默认 3 降到 1 或 2,EH 可能因为连接过多触发限流
  5. EH 临时过载:EH 偶尔会返回 429 或连接重置,等 1-2 分钟后重试

2. 暂停图标亮了但没手动暂停

可能是应用自己暂停了——检查下载设置里的"仅 Wi-Fi 下载"是否开启,如果你当前在移动网络下,所有下载会自动暂停。关闭这个选项或切换到 Wi-Fi 即可恢复。

3. 下载完了仍显示"下载中"

有极小概率是数据库写入延迟或 UI 没刷新。处理:

  1. 向下拉刷新下载列表
  2. 完全退出应用重新打开
  3. 如果仍然卡住 → 手动清理该任务(已下载的图片在本地,不会丢失)→ 重新从本地图库打开画廊

4. Archive Bot 下载超时

Archive Bot 服务偶尔会下线或响应变慢。处理:

  1. 在存档 Bot 设置里换另一个可用的 Bot 地址
  2. 暂时切换回逐图下载
  3. 检查 Bot 所有者是否更新了地址(EH 论坛搜索)

极端情况:清除下载数据库

如果下载问题持续、所有修复都无效,可以清除下载数据:

设置 → 数据 → 清除下载数据库(或类似选项)

⚠️ 这个操作会清空所有下载进度,已下载的图片文件不受影响,但需要手动重新加入下载队列。建议先导出配置备份。