BBDown项目视频下载异常问题解析与解决方案

问题现象描述

近期部分用户在使用BBDown工具下载B站视频时遇到了"Arg_KeyNotFound"错误。该问题表现为：在下载某些特定视频时工具会抛出异常，而其他视频仍能正常下载。错误信息显示为"Arg_KeyNotFound"，同时伴随有负数的aid值返回（如-497236948）。

问题根源分析

经过技术分析，该问题的根本原因在于BBDown的BV/AV号转换算法存在缺陷。具体表现为：

1. 算法限制：原算法支持的av号最大值约为2^27，当处理超过此范围的视频时，会解析出异常大的数字（接近2^64），导致int类型变量溢出，最终产生负数的aid值。

2. 时间相关性：由于B站视频编号随时间递增，近期（特别是2024年2月后）上传的视频更容易触发此问题，而较早的视频（如1月及之前）则不受影响。

3. 错误表现：当工具尝试使用负数的aid向B站API请求视频信息时，服务器返回400错误（请求错误），进而导致工具抛出"Arg_KeyNotFound"异常。

解决方案

目前已有两种可行的解决方案：

1. 使用最新Action版本：

   • 开发者已在GitHub Actions中修复了此问题
   • 新版本更新了BV/AV转换算法，能够正确处理大数值的av号

2. 清理缓存并更新：

   • 删除旧版本的缓存文件
   • 替换为最新发布的版本

技术背景补充

B站的视频标识系统经历了从纯数字av号到BV号的演变。早期的BBDown版本在处理某些BV号转换为av号时存在算法缺陷，特别是当av号超过一定范围时。新版本通过优化转换算法，解决了数值溢出的问题，确保了各种情况下的正确转换。

用户操作建议

对于遇到此问题的用户，建议采取以下步骤：

1. 检查当前使用的BBDown版本
2. 如版本较旧，建议升级到最新Action版本
3. 如问题仍然存在，可尝试清理工具缓存
4. 确认视频链接是否正确无误

通过以上措施，应该能够解决大部分因av号转换导致的下载失败问题。如遇其他特殊情况，建议关注项目的后续更新或提交详细的错误报告。