企业官网建设流程全解析

视频号视频下载失败怎么排查：res-downloader 从抓包到分块下载的完整链路

【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader

把一条视频号视频存到本地，操作其实只有两步：启动代理，点"直接下载"。但当进度卡在 97%、任务状态变红、本地连个完整文件都没留下时，问题通常不在"点没点"，而在这两件事上——分块下载的参数没调对，下载后的校验没过。res-downloader 从拦到资源到把文件写进硬盘，中间经历一条完整链路：代理抓包 → 资源筛选 → 分块下载 → 完整性校验 →（视频号）解密。链路里每个环节都有对应开关，看懂它们，"下载失败"就不再是玄学。

先看懂它做了什么：从拦到资源到文件落盘

res-downloader 本质是一个本地代理（默认 127.0.0.1:8899），和 Fiddler、Charles 同类：经过它的 HTTPS 流量会被解密检查，匹配到视频、音频、图片、m3u8 等 MIME 类型的条目，就进首页资源列表。

真正值得展开的是点"直接下载"之后的部分。它不是一条流慢慢拉完，而是先对资源地址发一次 HEAD 请求，拿到文件大小和服务器是否支持 Range，据此决定要不要分块：

fd.TotalSize = resp.ContentLength if fd.TotalSize <= 0 { fd.IsMultiPart = false // 拿不到大小，单任务下载 } else if resp.Header.Get("Accept-Ranges") == "bytes" && fd.TotalSize > MinPartSize { fd.IsMultiPart = true // 支持 Range 且大于 1MB，才走分块 }

这段逻辑在 core/downloader.go 的init()里，配合三个常量：

MaxRetries = 3 // 最大重试次数 RetryDelay = 3 * time.Second // 重试延迟 MinPartSize = 1 * 1024 * 1024 // 最小分片大小（1MB）

分块数默认取 CPU 核数 × 2，在设置页的"连接数"里可改（2~64）。每个分块失败会重试 3 次、每次间隔 3 秒；只要有分块失败，整个任务会自动降级为单流重下一次——这就是你偶尔看到"卡一下又继续跑"的原因。全部分块完成后，verifyDownload()做最后把关：

func (fd *FileDownloader) verifyDownload() error { for _, task := range fd.DownloadTaskList { if !task.isCompleted { return fmt.Errorf("task %d not completed", task.taskID) } } if fd.TotalSize > 0 { _, err := fd.File.Stat() if err != nil { return fmt.Errorf("get file info failed: %w", err) } } return nil }

任何一块没标记完成、或文件不可读，任务整体报失败。所以"进度到 99% 又失败"，几乎都是某个分块重试 3 次都没成功，而不是写盘写坏了。

上手调参：从能抓到、到下得快、再到稳

先保证能拦到：代理、证书、系统代理三件事

大多数"下不了"其实是"拦不到"。按顺序查三件事：首页左上角是否点了"启动代理"；系统代理是否指向 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

如果软件本身行为异常，按 docs/troubleshooting.md 的说法，直接删掉配置目录（macOS 在~/Library/Preferences/res-downloader，Windows 在%AppData%\res-downloader）再重启，是最快的恢复手段。

调对两个数字：连接数管分块，下载数管并行

设置页最值得动的就是两个数字。"连接数"是单个文件拆几个分块，默认核数 × 2；"下载数"是同时并行下载几个文件，范围 1~10，默认 3。

思路是反着来的：网络差、源站限流 → 把连接数调小（4~8），分块越多越容易撞上某个卡死的分块，还要多等几轮重试；网络好、文件大 → 调大（16~32）。注意两者是独立的：3 个视频同时下时，每个视频仍然按"连接数"拆块。

看懂失败提示：自动降级和视频号解密

这个阶段要记住两件事。第一，"task X not completed" 不用慌——自动降级（单流重下）已经触发过一轮了，此时先检查网络，或在设置页开启"下载代理"走上游代理再试。第二，视频号视频即使下载完成，也是加密文件，必须在操作列点"视频解密"才得到能正常播放的 mp4；想换清晰度，在设置页的"清晰度"项里切。

一次完整走查：从打开视频号到拿到成片

把上面的环节串起来，保存一条视频号视频的标准动作是：

1. 打开软件，首页左上角点"启动代理"，确认系统代理指向 127.0.0.1:8899；
2. 顶部"拦截类型"只勾"视频"，把列表噪音降下来；
3. 在微信里打开目标视频号视频，回到软件即可看到资源条目；
4. 点该行"直接下载"，状态列正常会一路走到 100%；
5. 完成后点"视频解密"，保存路径列出现_decrypt.mp4就是成品。

中途失败就回上一节对号入座：拦不到查代理证书，慢就调两个数字，反复失败看降级提示。小程序、抖音、m3u8、直播流等其他资源的拦截方式，docs/examples.md 里有逐类演示。

记住三句话

拦不到，查代理和证书；下得慢，调连接数和下载数；反复失败，等自动降级走完再动网络。视频号务必多一步"视频解密"，下完直接双击是打不开的。参数怎么都不对时，按 docs/troubleshooting.md 重置配置目录，比继续猜参数更快。

【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader