点击缓存后提示下载失败的排查

最常见原因

点击缓存后如果提示「下载失败」，80% 的情况与命名规则有关。这也是官方文档中专门提到的故障排查第一步。

BILIBILIAS 的默认命名规则包含 {P_TITLE} 变量——它会把视频的子集标题（P Title）拼进最终文件名。问题是视频标题里经常包含 Android 文件系统不允许的字符，比如：

这些字符在 Windows 和 Android 的文件系统中都有特殊含义，不能直接用作文件名。当 BILIBILIAS 尝试创建带这些字符的文件时，Android 系统会拒绝，导致下载失败。

另一个常见原因是视频标题太长——Android 的单文件名上限是 255 字符（加上路径总长度也有限制），如果 {P_TITLE} 展开后超长，同样会导致保存失败。

如果你想更彻底地测试，可以直接点击「还原命名规则」恢复默认值（默认规则里其实也包含 {P_TITLE}——如果还原后还不行，就手动删掉 {P_TITLE}）。

如果删掉 {P_TITLE} 后还是下载失败，依次排查：

Android 会对每个应用设置缓存目录的大小上限。打开设置 → 存储 → BILIBILIAS，看看是否还有可用空间。或者直接检查手机内部存储的剩余容量——如果只剩几百 MB 了，清理一下其他应用的缓存或卸载不用的应用。

虽然 BILIBILIAS 会处理一定程度的网络波动，但长时间断网、WiFi 信号极弱、或者运营商网络异常时下载还是会失败。尝试切换网络（WiFi ↔ 移动数据）或等网络稳定后重试。

极少数情况下，B 站接口返回的视频流数据本身就有问题——比如视频下架了、版权方暂时屏蔽了该视频的下载、或者 B 站后端正在维护。这种情况下没有任何客户端能成功下载，换个视频试试就能区分出是 BILIBILIAS 的问题还是 B 站接口的问题。

如果下载成功但在合并成 MP4 时失败，问题大概率出在合并命令的 FFmpeg 参数上。打开设置 → 合并配置，点击「还原」按钮恢复默认的合并命令——默认的接近无损合并是经过充分测试的，手动修改过的命令很容易因为参数错误导致合并失败。

修复完成后，从 BILIBILIAS 的下载列表中删除之前失败的任务，重新解析视频并提交缓存。成功的标志是文件出现在存储路径下，播放器能正常打开。