NavigationStack跳转VideoPreviewView崩溃：AVPlayerItem重复关联AVPlayer

核心问题拆解 #

崩溃的直接原因是同一个AVPlayerItem被绑定到了多个AVPlayer实例，而VideoPreviewView被初始化两次，说明系统创建了两个视图实例，各自生成了AVPlayer并关联了同一个playerItem，触发了Apple的安全限制。

分步解决办法 #

1. 给VideoPreviewView的AVPlayer加单例保障 #

在VideoPreviewView内部，用@StateObject来管理AVPlayer，确保整个视图生命周期里只有一个实例，不会因为视图重复初始化创建多个AVPlayer：

struct VideoPreviewView: View {
    let playerItem: AVPlayerItem
    @StateObject private var player: AVPlayer
    
    init(playerItem: AVPlayerItem) {
        self.playerItem = playerItem
        _player = StateObject(wrappedValue: AVPlayer(playerItem: playerItem))
    }
    
    var body: some View {
        VideoPlayer(player: player)
            .onDisappear {
                // 视图消失时清空player的item，避免后续关联冲突
                player.replaceCurrentItem(with: nil)
            }
    }
}

2. 修正导航路径的唯一性 #

如果你的导航路径用的是枚举或值类型，给每个预览视图的路径元素分配唯一ID，避免SwiftUI因为值重复重复创建视图：

// 让导航路径元素遵循Identifiable
enum NavStep: Identifiable {
    case picker
    case upload
    case preview(AVPlayerItem)
    
    // 给每个preview实例生成唯一ID
    var id: UUID {
        switch self {
        case .picker, .upload: return UUID()
        case .preview(let item): return UUID() // 或者用item关联资源的唯一标识，比如assetID
        }
    }
}

// ViewModel里的导航逻辑
class VideoVM: ObservableObject {
    @Published var navPath = [NavStep]()
    
    func goToPreview(with item: AVPlayerItem) {
        // 先清空可能存在的preview路径，避免重复添加
        navPath.removeAll(where: { if case .preview = $0 { return true } else { return false } })
        navPath.append(.preview(item))
    }
}

3. 排查视图重复初始化的隐藏原因 #

• 检查父视图中是否有不必要的@State或@Published属性刷新，导致NavigationStack重绘
• 不要在body闭包里创建AVPlayerItem或AVPlayer，把这些实例逻辑放到ViewModel中统一管理
• 如果用了列表或循环视图，确保每个元素的id唯一，避免SwiftUI复用视图时重复初始化

4. 手动切断旧的AVPlayer关联 #

在跳转预览前，先把AVPlayerItem从之前的AVPlayer中解绑，彻底避免多实例冲突：

func preparePreview(item: AVPlayerItem) {
    // 如果item已经被某个player持有，先解绑
    item.player?.replaceCurrentItem(with: nil)
    // 重置播放状态
    item.seek(to: .zero)
    item.pause()
    // 再跳转
    navPath.append(.preview(item))
}

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