Tautulli项目中的流计数异常问题分析与修复

问题现象

在Tautulli媒体服务器监控系统中，用户报告了一个关于流计数不准确的严重问题。具体表现为：系统记录的流数量会随着时间的推移不断增加，即使实际没有用户在进行流媒体播放。例如，当系统处于空闲状态时，Tautulli仍可能显示有5-6个活跃流，而实际上并没有任何用户在使用。

问题根源

经过开发团队深入分析，发现该问题的根本原因与预播片(preroll)功能有关。预播片是Plex服务器在播放主内容前插入的简短视频片段。当这些预播片持续时间非常短时，会影响Tautulli对观看状态的准确计算，导致流计数出现异常累积。

技术细节

Tautulli通过监控Plex服务器的活动日志来跟踪当前的流数量。正常情况下，当一个流开始时，计数器会增加；当流结束时，计数器会相应减少。然而，当遇到极短的预播片时：

1. 预播片的开始事件被正确记录
2. 但由于持续时间过短，结束事件可能未被正确处理
3. 导致系统认为该流仍在持续，计数器无法正确递减

这种异常情况会随着时间推移而累积，最终造成流计数远高于实际值。

解决方案

开发团队已经修复了这个问题，解决方案包括：

1. 改进了对极短持续时间流的检测逻辑
2. 增强了流结束事件的捕获机制
3. 优化了观看状态的计算算法

对于遇到此问题的用户，临时解决方案是禁用预播片功能，但这可能会影响用户体验。更好的方法是等待包含此修复的Tautulli新版本发布。

影响范围

该问题主要影响以下功能：

1. 基于流数量的通知触发器
2. 实时活动监控
3. 使用流数量作为条件的自动化脚本

最佳实践

为避免类似问题，建议用户：

1. 保持Tautulli更新到最新版本
2. 定期检查流计数是否与实际相符
3. 避免使用极短(小于1秒)的预播片
4. 对关键通知功能设置双重验证机制

该修复已合并到主分支，将在下一个Tautulli版本中发布。用户更新后即可解决此流计数异常问题。