Ani项目播放页剧集列表选择失效问题分析

问题现象

在Ani项目的播放页面中，用户反馈剧集列表选择功能失效，无法正常切换剧集。该问题在4.3.0版本中仍然存在，表现为点击剧集列表中的剧集或播放器中的"下一集"按钮均无响应。

技术分析

从日志信息可以看出，问题核心在于播放进度保存时出现的异常。具体错误表现为：

java.lang.IllegalStateException: Current position is greater than video duration: 1631109 > 1631062

这个异常发生在RememberPlayProgressExtension扩展中，当系统尝试保存播放进度时，发现当前播放位置超过了视频总时长，导致保存操作失败。

异常链分析

1. 异常触发点：在RememberPlayProgressExtension.savePlayProgressOrRemove方法中，系统检测到当前播放位置(1631109ms)大于视频总时长(1631062ms)，抛出IllegalStateException

2. 异常传播：

   • 首先被EpisodeFetchSelectPlayState捕获并包装为ExtensionException
   • 然后传播到EpisodeViewModel的后台协程中
   • 最终导致剧集切换流程中断

3. 影响范围：该异常不仅影响了播放进度保存功能，还中断了整个剧集切换流程，导致用户无法切换到下一集。

解决方案建议

1. 范围检查处理：在保存播放进度前，应增加对播放位置的合法性检查。当播放位置超过视频时长时，可以自动调整为视频时长值。

2. 异常恢复机制：对于此类非致命性异常，可以考虑捕获后继续执行后续操作，而不是中断整个流程。

3. 日志增强：增加更详细的调试日志，帮助定位播放位置计算异常的具体原因。

4. UI反馈：当发生此类错误时，应向用户提供友好的错误提示，而不是静默失败。

实现示例

以下是改进后的播放进度保存逻辑示例：

fun savePlayProgress(position: Long, duration: Long) {
    val adjustedPosition = when {
        position < 0 -> 0L
        position > duration -> duration
        else -> position
    }
    // 保存调整后的播放进度
    saveAdjustedProgress(adjustedPosition, duration)
}

总结

该问题揭示了在多媒体播放应用中处理播放进度时需要特别注意范围条件。特别是在剧集切换等关键流程中，应当设计健壮的异常处理机制，确保单一功能的异常不会影响核心用户体验。通过增加合理的范围检查和异常恢复机制，可以有效提升应用的稳定性和用户体验。