Bazarr字幕下载功能中LegendasDivX解析问题分析与修复

问题背景

Bazarr是一款优秀的字幕管理工具，但在1.4.3-beta.41版本中，用户反馈无法从LegendasDivX.pt网站下载葡萄牙语(Portugal)字幕。经过分析发现，这是由于Bazarr在构建搜索URL时使用了不正确的参数格式，导致搜索结果为空。

技术分析

错误现象

当用户尝试搜索如"Better Call Saul S02E04"的字幕时，Bazarr生成的URL包含多余的引号和参数，例如：

错误URL格式：

modules.php?name=Downloads&file=jz&d_op=search&op=_jz00&query=%2522better%20call%20saul%2520s02e04%2522&form_cat=28

而实际应使用的正确URL格式应为：

modules.php?name=Downloads&file=jz&d_op=search&op=_jz00&query=%2522better%20call%20saul%2520s02e04

问题根源

通过查看项目历史提交记录，发现这个问题源于对URL参数处理的多次修改：

1. 最初实现时未使用引号
2. 后来有提交添加了引号
3. 随后又移除了引号
4. 最后改为对引号和空格进行转义

这种反复修改导致URL构建逻辑不稳定，最终产生了错误的查询字符串格式。

解决方案

经过深入测试和验证，确定正确的URL构建规则应满足以下条件：

1. 对于单集搜索，应使用格式：

query=剧名%2520s季数e集数%2522&form_cat=28

2. 对于整季搜索，应使用格式：

query=剧名%2520s季数%2522&form_cat=28

其中%2522是双引号的二次URL编码表示，%2520是空格的二次URL编码表示。

技术实现要点

1. URL编码处理：需要正确处理特殊字符的编码，特别是引号和空格的多次编码
2. 参数顺序：确保查询参数(form_cat)位于正确位置
3. 字符串拼接：精确控制查询字符串的拼接逻辑，避免多余的字符

用户影响

该修复将影响所有使用Bazarr从LegendasDivX.pt下载葡萄牙语(Portugal)字幕的用户。修复后，用户将能够：

1. 正常搜索和下载单集字幕
2. 正常搜索和下载整季字幕包
3. 获得准确的搜索结果，避免"未找到字幕"的错误提示

总结

这个案例展示了网络爬虫和API集成中常见的URL构建问题。正确处理特殊字符编码和参数格式对于确保服务间正常通信至关重要。Bazarr开发团队通过分析历史变更和实际测试，最终确定了正确的URL构建方案，解决了用户无法下载字幕的问题。

该修复已包含在Bazarr的后续beta版本中，用户升级后即可恢复正常使用LegendasDivX.pt的字幕下载功能。