SwiftUI VideoPlayer播放m3u8仅首帧显示后停止，如何诊断？

问题现象 #

使用SwiftUI的VideoPlayer播放m3u8流时，仅播放一帧就冻结，内置播放按钮完全无响应。相关日志信息如下：

[api] -[CIImage initWithCVPixelBuffer:options:] failed because the buffer is nil.
Metal API Validation Enabled
[MADService] Client XPC connection invalidated

曾怀疑是视图重渲染导致问题，但已隔离播放器组件后情况未改善，且playVideo函数确认仅被调用一次。

当前代码实现 #

import SwiftUI
import AVFoundation
import AVKit

struct VideoPlayerView: View {
    @State private var player: AVPlayer = AVPlayer()
    @State var url: URL?
    var body: some View {
        return
            VideoPlayer(player: player)
                .onAppear {
                    playVideo()
                }
    }
    
    func playVideo() {
        if let newUrl = url {
            let newPlayerItem = AVPlayerItem(url: newUrl)
            player.replaceCurrentItem(with: newPlayerItem)
        } else {
            player.replaceCurrentItem(with: nil)
        }
    }
}

补充信息 #

该m3u8 URL在MacOS的VLC中可正常播放。

诊断排查步骤 #

1. 监听AVPlayerItem状态，定位加载错误 #

给AVPlayerItem添加状态监听，确认是否存在加载失败或资源错误：

// 建议将播放器逻辑封装到ObservableObject中，避免View层内存泄漏
class VideoPlayerManager: ObservableObject {
    let player = AVPlayer()
    private var observation: NSKeyValueObservation?
    
    func loadVideo(url: URL?) {
        guard let url = url else {
            player.replaceCurrentItem(with: nil)
            return
        }
        let playerItem = AVPlayerItem(url: url)
        // 监听状态变化
        observation = playerItem.observe(\.status, options: [.new]) { [weak self] item, change in
            guard let self = self else { return }
            switch item.status {
            case .readyToPlay:
                print("资源加载完成，准备播放")
                self.player.play()
            case .failed:
                print("资源加载失败：\(item.error?.localizedDescription ?? "未知错误")")
            case .unknown:
                print("资源状态未知，加载中")
            @unknown default: break
            }
        }
        player.replaceCurrentItem(with: playerItem)
    }
}

// 修改View结构
struct VideoPlayerView: View {
    @StateObject private var playerManager = VideoPlayerManager()
    var url: URL?
    
    var body: some View {
        VideoPlayer(player: playerManager.player)
            .onAppear {
                playerManager.loadVideo(url: url)
            }
    }
}

2. 处理自定义资源加载逻辑 #

部分m3u8流需要自定义请求头、证书验证，VLC会自动处理但AVPlayer需手动配置：

extension VideoPlayerManager: AVAssetResourceLoaderDelegate {
    func resourceLoader(_ resourceLoader: AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVAssetResourceLoadingRequest) -> Bool {
        // 示例：添加自定义请求头
        guard let mutableRequest = loadingRequest.request as? NSMutableURLRequest else {
            loadingRequest.finishLoading(with: NSError(domain: "InvalidRequest", code: -1, userInfo: nil))
            return false
        }
        // 根据实际需求添加请求头，比如Authorization
        mutableRequest.setValue("your-token", forHTTPHeaderField: "Authorization")
        
        let task = URLSession.shared.dataTask(with: mutableRequest as URLRequest) { data, response, error in
            DispatchQueue.main.async {
                if let data = data, let response = response {
                    loadingRequest.dataRequest?.respond(with: data)
                    loadingRequest.contentInformationRequest?.contentType = response.mimeType
                    loadingRequest.finishLoading()
                } else {
                    loadingRequest.finishLoading(with: error)
                }
            }
        }
        task.resume()
        return true
    }
}

// 修改loadVideo方法，使用AVURLAsset并设置resourceLoader
func loadVideo(url: URL?) {
    guard let url = url else {
        player.replaceCurrentItem(with: nil)
        return
    }
    let asset = AVURLAsset(url: url)
    asset.resourceLoader.setDelegate(self, queue: DispatchQueue.global())
    let playerItem = AVPlayerItem(asset: asset)
    
    observation = playerItem.observe(\.status, options: [.new]) { [weak self] item, change in
        // 状态监听逻辑同前
    }
    player.replaceCurrentItem(with: playerItem)
}

3. 强制播放器触发播放逻辑 #

部分场景下AVPlayer不会自动启动播放，需手动调用play()：
在playerItem.status变为.readyToPlay时，主动调用player.play()（已包含在步骤1的代码中）。

4. 排查Metal渲染相关问题 #

日志中出现Metal相关错误，可尝试：

• 禁用Metal API Validation：在Xcode的Edit Scheme -> Run -> Arguments中，移除METAL_API_VALIDATION_ENABLED环境变量
• 强制使用软件解码：

let playerItem = AVPlayerItem(url: url)
// 设置偏好缓冲时长，强制软件解码
playerItem.preferredForwardBufferDuration = 2.0
playerItem.preferredPeakBitRate = 1000000 // 根据流的码率调整

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