iOS中AVPlayer在WiFi与蜂窝网络切换时卡顿30-60秒求助

核心原因分析 #

WiFi与蜂窝网络切换时，AVPlayer默认的网络请求重试逻辑、HLS分片缓存策略以及系统网络层的连接重建耗时，是导致30-60秒卡顿的主要原因。默认情况下，AVPlayer会等待原有连接超时后才会尝试重新拉取分片，这个超时周期刚好对应你遇到的卡顿时长。

可行优化方案 #

1. 主动监控网络状态并触发HLS播放列表刷新 #

不要只在网络切换时暂停/重建播放器，而是在检测到网络切换完成后，主动调用AVPlayerItem的reloadMetadata()方法，强制刷新播放列表，让播放器尽快获取新网络环境下的分片地址：

// 网络切换完成后执行
if let currentItem = player.currentItem {
    currentItem.reloadMetadata()
}

同时可以配合监听AVPlayerItemNewAccessLogEntry通知，查看网络切换后的请求状态，确认是否成功刷新。

2. 自定义HLS加载器（AVAssetResourceLoaderDelegate） #

通过实现AVAssetResourceLoaderDelegate，接管HLS的分片请求逻辑，自定义网络请求的超时时间和重试策略：

• 在网络切换时，主动取消当前正在进行的分片请求
• 设置更短的请求超时时间（比如10秒），超时后立即重试
• 针对不同网络环境（WiFi/蜂窝），可以提前配置不同的请求参数（比如蜂窝网络下优先拉取低码率分片）

示例代码片段：

func resourceLoader(_ resourceLoader: AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVAssetResourceLoadingRequest) -> Bool {
    // 自定义网络请求逻辑，设置超时
    let urlRequest = loadingRequest.request
    let task = URLSession.shared.dataTask(with: urlRequest) { data, response, error in
        // 处理请求结果，回调给loadingRequest
        if let data = data, let response = response {
            loadingRequest.dataRequest?.respond(with: data)
            loadingRequest.finishLoading(with: response)
        } else {
            loadingRequest.finishLoading(with: error ?? NSError(domain: "CustomLoader", code: -1, userInfo: nil))
        }
    }
    task.timeoutInterval = 10
    task.resume()
    return true
}

3. 优化缓存策略，提前预加载关键分片 #

在网络切换前，提前缓存后续几个HLS分片（比如3-5个），确保切换过程中有足够的缓存内容维持播放：

• 通过AVPlayerItem的accessLog获取当前播放的分片索引
• 主动请求后续分片并缓存到本地
• 网络切换时，播放器优先使用本地缓存的分片，避免立即发起网络请求

4. 调整AVPlayer的缓冲配置（结合场景） #

虽然你试过preferredForwardBufferDuration，但可以针对不同网络动态调整：

• WiFi环境下设置较长的缓冲时长（比如60秒）
• 蜂窝网络下设置较短的缓冲时长（比如15秒）
• 网络切换时，暂时将automaticallyWaitsToMinimizeStalling设为false，强制播放器使用现有缓存继续播放，直到新的网络请求成功

// 网络切换时临时调整
player.automaticallyWaitsToMinimizeStalling = false
// 当检测到新网络下的分片请求成功后，再恢复默认设置
player.automaticallyWaitsToMinimizeStalling = true

额外注意事项 #

• 确保HLS服务器支持断点续传，避免网络切换后重新下载整个分片
• 测试不同iOS版本的行为差异，部分版本的AVPlayer在网络切换时的逻辑有优化

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