MALSync项目中的Jellyfin自定义域名子路径忽略问题分析

问题背景

在MALSync项目中，当用户将Jellyfin媒体服务器配置在反向代理后的子路径下时(例如https://example.org/jellyfin/)，系统生成的快速链接和继续观看等功能的URL会错误地忽略配置的子路径部分。这个Bug会导致用户无法通过这些链接直接访问正确的Jellyfin资源路径。

技术细节分析

该问题主要出现在URL拼接逻辑中。当MALSync扩展尝试生成指向Jellyfin资源的链接时，它错误地使用了基础域名而忽略了配置的子路径部分。例如：

• 正确期望的URL：https://example.org/jellyfin/item/123
• 实际生成的URL：https://example.org/item/123

从技术实现角度看，这通常是由于以下原因之一造成的：

1. URL拼接函数没有正确处理baseUrl参数
2. 服务器地址配置在存储或读取时丢失了子路径信息
3. 前端JavaScript在生成链接时没有考虑完整的服务器路径

问题验证方法

开发团队建议通过以下方法验证服务器地址配置是否正确：

1. 在浏览器开发者工具中打开控制台
2. 输入命令：ApiClient._serverAddress
3. 检查返回值是否包含完整的子路径(如https://mydomain.example.org/jellyfin)

解决方案思路

要解决这个问题，开发团队需要：

1. 确保服务器地址在配置存储时完整保留子路径信息
2. 修改URL生成逻辑，确保所有链接都基于完整的服务器地址构建
3. 添加测试用例验证子路径场景下的URL生成
4. 考虑边缘情况，如地址末尾斜杠的处理

对用户的影响

这个Bug会影响所有将Jellyfin部署在子路径下的MALSync用户，导致他们无法通过扩展提供的快捷功能直接访问媒体内容。虽然用户仍可以通过手动修改URL访问资源，但这显著降低了使用体验。

总结

子路径支持是Web应用和扩展开发中常见的需求，正确处理URL拼接对于提供良好的用户体验至关重要。MALSync团队需要完善其URL处理逻辑，确保在各种部署场景下都能生成正确的资源链接。这个问题也提醒开发者，在开发类似扩展时，应该充分考虑用户可能的各种部署方式，包括根域名和子路径部署场景。