SunGet · 下载与任务

下载任务失败了,按什么顺序排查?

先看任务卡片:失败任务会显示错误原因,并在下方给出一条针对性建议,点「复制错误」可以把日志复制出来。常见原因和对应处理:一,提示需要登录或 Fresh cookies(抖音、B站最常见):到「偏好设置 › 下载 › 账号登录环境检测」,在 SunGet 内置浏览器里登录对应平台后重新检测,再重试任务。二,提示需要 ffmpeg:在「偏好设置 › 下载 › 下载环境检测」里安装或修复 ffmpeg,合并音视频流必须用到它。三,提示 yt-dlp 偏旧或无法识别链接:到「高级 › 工具诊断」检查并更新 yt-dlp;下载时未找到 yt-dlp 会自动尝试安装,失败时也可以手动把对应平台的 yt-dlp 放到 tools 目录。四,读取浏览器 Cookies 失败(Edge/Chrome 正在运行):关闭对应浏览器后重试,或改用 cookies.txt。五,网络超时或平台限流:稍后再试;抖音连续失败会自动进入防限流冷却。

WindowsmacOS适用版本:9.13适用版本:9.13.0

内容核验:

分步操作

  1. 复制错误日志

    在失败任务卡片上点「复制错误」,记录原始提示。

  2. 按提示登录

    提示需要登录/Cookies 时,到「偏好设置 > 下载 > 账号登录环境检测」用内置浏览器登录抖音或 B站,刷新页面后重新检测。

  3. 检查工具组件

    提示 ffmpeg 缺失或 yt-dlp 偏旧时,在「偏好设置 > 下载 > 下载环境检测」和「高级 > 工具诊断」中检查、修复、更新。

  4. 重试任务

    处理完成后在任务卡片点「重试」,任务会重新排队。

预期结果

任务重新进入队列并完成下载;工具诊断面板显示 yt-dlp / ffmpeg / ffprobe 状态正常。

异常与解决

提示「自动安装 yt-dlp 失败」

可能原因:自动下载失败且内置兜底也不可用

解决方法:检查网络后重试,或手动把对应平台的 yt-dlp 放到 tools 目录。

B站提示分离音视频流失败

可能原因:B站返回 DASH 分离流,需要 ffmpeg 合并

解决方法:安装或修复 ffmpeg;如为合集或多分 P,请逐条下载。

抖音任务显示「等待防限流冷却」

可能原因:连续失败较多,软件自动进入冷却

解决方法:等待冷却结束后自动重试,或稍后手动点重试。

YouTube 提示没有可用的 JavaScript runtime

可能原因:yt-dlp 需要 Node.js 或 Deno 解析 YouTube

解决方法:安装 Node.js 或 Deno,或在「高级 > 工具诊断」更新 yt-dlp 后重试。

注意事项

  • yt-dlp、ffmpeg、ffprobe 是下载组件,缺失时软件会尝试自动安装;自动失败不代表网络或账号问题,先看工具诊断。
  • SunGet 不会自动突破平台登录墙、验证码或付费内容;这类提示按「平台登录限制」处理。