Downkyi无法下载合集常见问题解析

Question

问题：使用Downkyi下载B站合集视频时，常出现“合集解析失败”或“无法获取分P列表”的错误提示。此问题多因网页版合集页面结构变更、Cookies未正确加载或目标合集包含隐藏分集（如仅会员可见）导致。此外，部分用户未启用“自动登录状态检测”，致使程序无法获取完整权限信息。该问题会导致合集批量下载功能失效，只能手动逐个添加视频，严重影响效率。如何排查并解决此类合集解析异常？

Answer 1

一、问题背景与现象分析

在使用 Downkyi 下载 B站（哔哩哔哩）合集视频时，用户频繁遭遇“合集解析失败”或“无法获取分P列表”的错误提示。该类异常直接导致批量下载功能瘫痪，迫使用户手动逐个添加视频链接，极大降低自动化效率。

根据社区反馈及日志分析，主要成因包括：

• 网页端合集页面的 DOM 结构发生变更，导致原有选择器失效；
• Cookies 未正确加载或过期，影响身份认证状态；
• 目标合集包含仅限大会员可见的隐藏分集，普通权限无法访问完整列表；
• 未启用“自动登录状态检测”，程序无法感知登录失效或权限降级。

以下将从基础排查到深度调试，系统化梳理解决方案。

二、初级排查：配置与环境检查

1. 确认 Downkyi 是否为最新版本（v1.4.0+ 推荐），旧版本可能不兼容新版 B站 API；
2. 检查是否已登录账号并成功导出 Cookies —— 可通过浏览器插件如 Cookie-Editor 导出 JSON 格式 Cookie；
3. 在 Downkyi 设置中启用“自动登录状态检测”功能，确保每次请求前验证会话有效性；
4. 尝试更换网络环境（如切换至家庭宽带），排除 CDN 或 IP 封禁可能性；
5. 关闭广告拦截插件或隐私保护扩展，防止干扰 Cookie 注入过程。

三、中级诊断：Cookies 与权限验证流程

检查项	预期值	实际值位置	修复建议
bili_jct	存在且非空	Cookies 中	重新登录获取
DedeUserID	数字ID	Cookies 中	确认已登录
SessData	长字符串	Cookies 中	需保持登录态
SESSDATA	关键认证字段	必须有效	定期刷新
同站请求头 Referer	https://www.bilibili.com	模拟浏览器行为	设置伪装 UA 和 Referer
大会员标识	VIP=1	响应头或 body 中	升级会员权限
HTTP 状态码	200	抓包查看	避免 403/412
User-Agent	标准桌面浏览器	请求头中	不可为空或默认值
X-Requested-With	XMLHttpRequest	AJAX 请求必备	补全请求头
Origin	https://www.bilibili.com	跨域请求校验	一致性校验

四、高级调试：结构变更与接口逆向工程

当上述步骤无效时，应怀疑 B站前端结构已更新。可通过 Chrome DevTools 抓取真实请求链路：

// 示例：手动调用 B站合集分P接口
GET https://api.bilibili.com/x/polymer/space/seasons/episodes/list?season_id=56789
Headers:
  User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)
  Cookie: SESSDATA=xxx; bili_jct=yyy; DedeUserID=zzz;
  Referer: https://space.bilibili.com/12345678/collectiondetail?sid=56789

// 成功响应片段
{
  "code": 0,
  "message": "success",
  "data": {
    "episodes": [
      { "id": 1001, "title": "P1", "arc": { "bvid": "BV1xxxyyyzzz" } },
      { "id": 1002, "title": "P2", "arc": { "bvid": "BV1aabbccee" } }
    ]
  }
}

若此接口返回 code=-403，说明权限不足或 Cookie 失效；若返回空列表，则可能是 season_id 解析逻辑错误，需定位页面 JS 中动态生成的元数据。

五、综合解决方案流程图

graph TD
    A[启动 Downkyi] --> B{是否启用自动登录检测?}
    B -- 否 --> C[开启“自动登录状态检测”]
    B -- 是 --> D[导入有效 Cookies]
    D --> E{能否访问公开合集?}
    E -- 否 --> F[检查网络与UA设置]
    E -- 是 --> G{是否含会员专属内容?}
    G -- 是 --> H[登录大会员账号并更新Cookie]
    G -- 否 --> I[抓包分析实际请求URL]
    I --> J{API返回403/412?}
    J -- 是 --> K[更换User-Agent或延迟请求频率]
    J -- 否 --> L[解析DOM或JSON成功→开始下载]

六、预防机制与自动化建议

• 建立 Cookie 定期刷新脚本，结合 Selenium 自动化登录后提取最新凭证；
• 配置本地代理中间层（如 mitmproxy），记录并比对不同时间点的响应差异；
• 监控 B站前端变更，订阅官方公告或开源项目更新（如 github.com/leiurayer/downkyi）；
• 开发自定义插件模块，支持动态注入 XPath 或正则表达式匹配新结构；
• 对加密字段（如 CSRF Token）实现自动提取与填充机制；
• 采用 Puppeteer 或 Playwright 模拟真实浏览器行为，绕过反爬策略；
• 设置失败重试策略，间隔随机延时（1~3秒），避免触发风控；
• 日志分级输出（DEBUG/INFO/WARN），便于快速定位断点；
• 引入 CI/CD 流程，自动化测试主流合集解析成功率；
• 构建私有缓存服务器，存储已知 season_id 与 BV 号映射关系。