res-downloader 下载失败修复指南三类报错快速定位一次改对设置【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloaderres-downloader 通过代理抓包把视频号、m3u8、直播流等资源存到本地。下载失败卡在 99%多半逃不出三类传输断流、源不支持分段、磁盘写入失败。本文按报错定位指到具体配置字段并给出修好的验证信号。一分钟定位先判断你属于哪类故障用界面里的报错信息直接对号入座不用碰代码提示列表看不到资源或不是私密链接 → 不是下载问题是拦截问题跳到修证书和代理一节是下载失败的报错看关键字read response failed→ 传输中某段断了看调大任务数让断掉的段自动补下server does not support range requests→ 源拒绝了分段看遇到不支持 Range 的源改走整段下载no space left on device→ 本地磁盘问题看改保存目录并确认磁盘剩余空间。这三种下载失败都发生在 core/downloader.go 的分片流程里文件被切成几段每段由一个任务负责下完最后校验文件完整性。知道断在哪一层改哪里就不会错。调大任务数让断掉的段自动补下现象进度停在 99%日志出现task 0 failed after 3 attempts: read response failed: …。根因多段并行下载时网络抖动或服务端限流会让某一段中断单个任务的重试次数是固定常量重试耗尽该段就判失败MaxRetries 3 // 最大重试次数 RetryDelay 3 * time.Second // 重试延迟操作打开设置界面找到任务数输入框即 frontend/src/views/setting.vue 里的TaskNumber取值范围 2–64默认是 CPU 核数 ×2定义在 core/config.go。改成更大的值比如 16段数变多、每段更小断了只重下那一小段整体进度不容易卡死。保存设置后对该资源重新触发下载。验证日志出现Task N failed (attempt 1/3)后自动隔 3 秒重试并继续走进度不再卡 99%文件完整度走完 100% 并通过完整性校验。遇到不支持 Range 的源改走整段下载现象日志报server does not support range requests, status: 200。根因分片下载靠 Range 请求按字节区间取文件。启动前程序会先发 HEAD 探测只有响应带Accept-Ranges: bytes且文件大于 1MB 才会切段这个报错说明源收到分段请求后回了 200 而不是 206分片策略对它不成立。操作设置里把任务数TaskNumber放回最小值 2不要再调大回到资源列表点该资源操作列的重试重新抓取仍报同样错误说明该源完全不配合分段只能整段取等源变更或重新分享拿新地址。验证日志不再出现server does not support range requests进度条按整段走到 100%。改保存目录并确认磁盘剩余空间现象报write file failed at offset …: no space left on device。根因这个错与网络无关——文件已打开并预留了空间写到指定偏移时落盘被拒通常是磁盘满或目录不可写保存目录对应 core/config.go 的SaveDirectory默认是~/Downloads。操作查保存目录所在磁盘的剩余空间确保大于待下载资源的体积空间不够就在设置里把保存目录改成另一个磁盘重新下载文件会落到新目录。验证日志不再出现write file failed新保存目录中出现文件体积与资源列表显示一致。修证书和代理恢复资源拦截现象资源列表为空或链接提示不是私密链接。根因res-downloader 靠代理127.0.0.1:8899抓流量HTTPS 资源还要求系统信任它的抓包证书证书没装进受信任根私密链接解不开下载无从谈起。操作确认系统代理指向127.0.0.1端口8899仍提示不是私密链接就把证书手动装为受信任根证书Mac 在终端执行sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain /Users/$(whoami)/Library/Preferences/res-downloader/cert.crt验证重新打开软件后资源列表能抓到资源下载不再报不是私密链接。防止复发弱网下别把TaskNumber拉满到 648–16 这种中间值兼顾速度与断流概率下大文件前先确认保存目录剩余空间大于文件体积省得整份重下首次使用前就装好并信任证书别等不是私密链接弹出再处理。本文覆盖的是下载启动之后的三类下载失败如果软件起不来或装完证书仍反复提示查 docs/troubleshooting.md想复现抓取与下载流程参考 docs/examples.md 与 docs/installation.md。res-downloader 的分片与校验逻辑仍在调整建议定期升级到最新版。【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考