Aniyomi播放器中的追踪服务重复请求问题分析

问题背景

在Aniyomi动画播放器中，当用户观看剧集并触发标记为已观看的逻辑时，追踪服务（如Anilist、MyAnimeList）会出现重复请求的问题。这会导致追踪平台上出现重复的活动记录或同一集被多次计数的情况。

技术原理

播放器在以下场景会出现异常行为：

1. 用户观看剧集达到标记为"已观看"的进度阈值
2. 系统触发追踪服务更新
3. 在数据同步过程中，本地与远程状态反复比对
4. 导致多次PUT请求被发送到追踪服务API

问题根源分析

通过代码审查发现，PlayerViewModel中存在潜在的竞态条件。当播放进度超过标记阈值时，系统会：

1. 先获取当前远程状态(GET)
2. 立即发送更新请求(PUT)
3. 在PUT请求完成前，可能再次触发状态检查
4. 导致重复的PUT请求被发送

核心问题在于缺乏请求状态管理和去重机制。

解决方案

开发者提出了两种解决思路：

1. 条件过滤方案 在发送更新请求前增加!currentEp.seen判断，避免对已标记剧集的重复操作。这种方案实现简单但存在局限性，无法处理请求失败等边缘情况。

2. 状态管理方案 更完善的解决方案应包括：

• 请求队列管理
• 请求去重机制
• 错误重试策略
• 状态同步锁

后续进展

该问题已在预览版中通过合并Mihon的代码得到修复。新版本引入了更健壮的追踪服务同步机制，有效防止了重复请求的产生。

技术启示

这类问题在客户端与服务端同步场景中很常见，开发者需要注意：

1. 网络请求的幂等性设计
2. 本地状态与远程状态的同步时机
3. 并发请求的控制
4. 错误处理与恢复机制

对于类似的多服务集成场景，建议采用状态机模式来管理同步流程，确保数据一致性。