切换m3u8码率档位触发BufferStalledError报错问题求助

问题背景 #

当前playlist.m3u8配置4路HLS码流，对应规格与档位映射如下：

• 档位0：1080p60
• 档位1：1080p30
• 档位2：720p60
• 档位3：480p30
  画质切换通过nextLevel接口实现，已复现的异常规律：
• 直接跳转至480p30、720p60档位时播放正常
• 所有60fps档位（1080p60、720p60）之间互相切换无异常
• 当currentLevel停留在480p30档位时，向上切换至1080p60、720p60档位会固定抛出mediaError: bufferStalledError，播放停滞

排查与解决思路 #

• 优先校验多码流的GOP与关键帧对齐情况
  这类跨帧率切流卡滞90%以上是关键帧不对齐导致的：检查转码输出配置，确认4路码流的关键帧间隔完全一致，所有档位的关键帧时间点严格对齐。如果480p30的关键帧位置和60fps档位偏移超过1个帧间隔，切流时播放器拉取到的新档位第一个分片不是有效关键帧，就会出现解码失败、缓冲区数据无法消费的问题，最终触发stalled报错。
• 补全跨参数切流的discontinuity标记
  检查m3u8索引文件，30fps和60fps档位之间切换的分片边界如果存在编码参数（帧率、编码Profile、时间戳基准）变更，必须添加#EXT-X-DISCONTINUITY标记，告知播放器此处需要重置解码上下文、重置时间戳计算逻辑。多数通用转码模板默认不会在跨帧率码流间加这个标记，很容易触发这类切流错误。
• 调整跨帧率切流时的缓冲区处理逻辑
  从30fps档位切到60fps档位时，不要直接将新分片追加到现有缓冲区：先调用播放器的flushBuffer接口清空当前视频、音频缓冲区的残留旧帧率数据，再从当前播放位置对应的最近关键帧开始加载新档位分片。旧缓冲区残留的30fps帧时间戳和新的60fps帧时间戳步长不一致，会导致播放器误判缓冲区长度，错误触发stalled逻辑。
• 调高跨档位切换的初始缓冲阈值
  从低码率480p30切到高码率60fps档位时，分片体积会提升2-3倍，默认的同帧率切流缓冲阈值（通常为0.3-0.8秒）不足以支撑平滑衔接，可以将跨帧率切流后的初始缓冲阈值临时调高到1.5-2秒，等新档位分片缓冲到足够长度后再启动解码，避免因为分片加载瞬时速度不足触发stalled误报。

内容的提问来源于stack exchange，提问作者adrics97