Bazarr字幕时间调整功能故障排查指南

功能背景

Bazarr作为一款自动化字幕管理工具，其"Adjust Times"功能允许用户批量调整字幕时间轴。该功能在字幕与视频存在固定时间偏移时尤为实用，可通过毫秒、秒、分钟或小时为单位进行整体平移。

典型故障现象

用户反馈在Linux环境（TrueNAS Scale）下使用Bazarr 1.4.5版本时，出现以下异常情况：

1. 执行时间调整操作后，界面显示任务完成提示
2. 历史记录中无相应操作日志
3. 实际字幕文件时间轴未发生改变
4. 其他功能（如帧率同步）工作正常

技术分析

经开发团队验证，该问题存在以下特征：

1. 首次成功率：服务重启后首次操作通常成功
2. 渐进式失效：后续操作可能出现间歇性失效
3. 日志记录缺失：该功能设计上不记录历史操作（与同步功能不同）

解决方案

临时解决方案

1. 执行关键操作前重启Bazarr服务
2. 通过SSH连接到服务器执行：

   sudo systemctl restart bazarr
   

3. 限制单次调整幅度，避免大跨度时间调整

永久解决方案（开发者建议）

1. 等待后续版本更新（该问题已被标记为待修复）
2. 考虑升级到测试版（部分用户反馈beta版本表现更稳定）

技术验证方法

建议用户通过以下方式确认功能是否实际生效：

1. 调整前备份原字幕文件（如subtitle.srt.bak）
2. 执行时间调整操作
3. 使用diff工具对比文件差异：

   diff -u subtitle.srt.bak subtitle.srt
   

4. 观察时间码（格式00:00:00,000）是否发生预期偏移

最佳实践建议

1. 重要操作前始终备份字幕文件
2. 分阶段进行时间调整（先大范围粗调，后小范围微调）
3. 结合播放器验证调整效果（推荐使用VLC或MPV等支持实时重载字幕的播放器）

注：该问题可能与特定Linux环境下的文件写入机制有关，Windows环境用户较少报告同类问题。