AVFoundation获取音频averagePowerLevel时触发NSRangeException崩溃求助

API 探路者

2026-8-26

问题分析与解决方案

从崩溃栈可以看出，崩溃发生在AVCaptureConnection的getAvgAudioLevelForChannel:方法内部，触发了数组索引越界。这是因为audioChannels是动态变化的集合——当音频输入设备的通道数改变（比如用户切换麦克风、插拔外接音频设备），系统会在后台线程更新这个数组，而你的updateMeters方法通过定时器在主线程遍历该数组，并发访问导致遍历过程中数组元素数量变化，进而触发系统内部的索引越界。

修复方案

方案1：创建数组快照后遍历

先将audioChannels复制为本地快照，再遍历这个固定的快照集合，避免原数组动态修改带来的问题：

func updateMeters() {
    var decibels: [Float] = []
    
    guard let audioConnection = self.audioConnection else { return }
    // 生成audioChannels的本地快照，隔绝原集合的动态变化
    let audioChannelsSnapshot = Array(audioConnection.audioChannels)
    
    for audioChannel in audioChannelsSnapshot {
        decibels.append(audioChannel.averagePowerLevel)
    }
    // 后续使用decibels的逻辑...
}

方案2：加锁实现线程同步

如果需要更严格的线程安全控制，可以使用锁来确保访问audioConnection和audioChannels时无并发修改：

// 定义全局锁对象
private let audioConnectionLock = NSLock()

func updateMeters() {
    var decibels: [Float] = []
    
    audioConnectionLock.lock()
    defer { audioConnectionLock.unlock() }
    
    guard let audioConnection = self.audioConnection else { return }
    for audioChannel in audioConnection.audioChannels {
        decibels.append(audioChannel.averagePowerLevel)
    }
    // 后续使用decibels的逻辑...
}

注意：所有访问self.audioConnection及其内部属性的代码，都需要用同一个锁同步，避免遗漏导致线程问题。