gallery-dl项目中的Bunkr插件重定向问题分析与修复

问题背景

gallery-dl是一款流行的媒体下载工具，支持从多个网站下载图片和视频。其中Bunkr插件用于处理Bunkr网站的内容下载。近期发现该插件在处理某些Bunkr专辑时会出现间歇性的ValueError异常，导致下载失败。

问题现象

当用户尝试下载某些Bunkr专辑时，例如使用命令gallery-dl https://bunkr.cr/a/4oCihUYU，工具会抛出"ValueError: substring not found"错误。通过调试日志可以看到，问题发生在处理HTTP重定向的过程中。

技术分析

错误根源

问题出在BunkrAlbumExtractor类的_split方法中。该方法尝试通过查找URL中第8个字符后的"/"来分割URL为根域名和路径部分。然而，当遇到301重定向返回的相对路径（如/f/rEeTUL8MXR17A）而非完整URL时，这种基于固定位置的字符串处理方式就会失败。

重定向流程分析

1. 初始请求发送到bunkr.cr
2. 被重定向到bunkrrr.org（307状态码）
3. 再次重定向到bunkr.ph（301状态码）
4. 此时Location头可能返回完整URL或相对路径

当Location头返回相对路径时，当前代码无法正确处理，因为它假设所有重定向URL都是完整的绝对URL。

解决方案

修复思路

更稳健的处理方式应该是：

1. 检查Location头是否以"/"开头（相对路径）
2. 如果是相对路径，则基于当前响应URL构建完整URL
3. 否则按原有逻辑处理

具体实现

核心修复代码在BunkrAlbumExtractor类的request方法中：

# redirect
url = response.headers["Location"]
if url[0] == "/":
    url = text.root_from_url(response.url) + url
    continue
root, path = self._split(url)

这个修改确保无论Location头返回的是绝对URL还是相对路径，都能正确构建后续请求的完整URL。

技术启示

这个案例给我们几个重要的技术启示：

1. HTTP重定向处理：必须考虑服务器可能返回的各种重定向形式，包括相对路径和绝对路径
2. URL解析：应该使用专门的URL解析库而非简单的字符串操作，以提高代码健壮性
3. 错误处理：对于网络请求这类不可靠操作，需要有完善的错误处理机制

总结

gallery-dl项目对Bunkr插件的这一修复，解决了因重定向URL格式不一致导致的下载失败问题。通过更智能地处理HTTP重定向，提高了工具的稳定性和可靠性。这也是一个很好的案例，展示了如何正确处理Web请求中的各种边缘情况。