Bazarr项目中的路径映射问题排查与解决方案

问题背景

在使用Bazarr进行字幕管理时，用户可能会遇到"Error 500 Episode file not found. Path mapping issue?"的错误提示。这种情况通常发生在用户修改了Sonarr中电视节目的存储位置后，虽然路径在Sonarr中显示已更新，但在Bazarr中搜索字幕时却出现错误。

问题表现

当用户执行以下操作时会出现问题：

1. 在Sonarr中修改了电视节目的存储路径
2. 路径修改在Sonarr中显示已成功
3. 在Bazarr中尝试搜索该节目的字幕
4. 系统返回500错误，提示找不到剧集文件或路径映射问题

根本原因分析

这个问题通常由以下几个因素导致：

1. 路径映射不一致：虽然Sonarr、Radarr和Bazarr的路径映射设置看起来相同，但实际上可能存在细微差异或缓存未更新。

2. 权限问题：不同的服务可能使用不同的用户/组运行，导致文件访问权限不足。

3. 数据同步延迟：修改路径后，系统间的同步可能存在延迟或未完全执行。

4. 缓存未清除：Bazarr可能缓存了旧的路径信息，导致无法识别新的文件位置。

解决方案

方法一：重新添加电视节目

1. 在Sonarr中删除有问题的电视节目
2. 重新添加该电视节目到Sonarr
3. 等待Bazarr自动同步更新

这是最简单直接的解决方案，适用于大多数情况。

方法二：检查并修复权限

1. 确认Sonarr和Bazarr运行使用的用户/组
2. 确保两个服务对媒体文件都有读写权限
3. 必要时调整文件系统权限设置

方法三：手动同步

1. 在Bazarr中进入"系统"->"任务"
2. 手动执行"同步所有"操作
3. 检查同步日志是否有错误信息

方法四：清除缓存

1. 停止Bazarr服务
2. 删除Bazarr的缓存文件（位置取决于安装方式）
3. 重新启动Bazarr服务

预防措施

1. 统一路径映射：确保所有相关服务(Sonarr、Radarr、Bazarr)使用完全一致的路径映射方案。

2. 定期维护：定期检查系统同步状态，特别是进行大规模文件移动或重命名后。

3. 权限规划：在部署初期就规划好各服务的运行用户和文件系统权限。

4. 监控日志：定期检查各服务的日志文件，及时发现潜在问题。

总结

Bazarr与Sonarr之间的路径映射问题虽然常见，但通常可以通过简单的重新添加节目或权限调整解决。理解这些服务之间的交互原理有助于快速定位和解决问题。对于更复杂的情况，建议检查详细的调试日志以获取更多信息。