SwiftUI中onAppear调用AVAudioPlayer出现背景音乐重复播放问题

• onAppear 触发机制问题：SwiftUI 中视图的 onAppear 回调并非全局仅执行一次，只要视图重新进入可见区域就会触发，包括应用前后台切换、父视图状态变化导致重绘、页面跳转后返回主界面等场景，会反复调用播放方法。
• 播放逻辑无防重复校验：playBackgroundMusic 方法每次被调用时，都直接创建新的 AVAudioPlayer 实例并调用播放，没有判断是否已有正在运行的播放器。旧实例失去引用后不会自动停止播放，会继续运行直到系统回收资源，最终形成多音频重叠的效果。
• 实例修饰符使用错误：示例中使用 @ObservedObject 修饰 AudioController 实例，而 @ObservedObject 并不持有实例的所有权，当 ContentView 因状态变化重绘时，会重新生成 AudioController 实例，旧实例持有的播放器没有被停止，依旧在后台播放。

可以根据需求选择以下一种或多种方案组合使用：

方案1：给播放逻辑增加防重复判断 #

在创建新播放器前，先判断是否已有实例存在，避免重复创建：

class AudioController: ObservableObject {
     var player: AVAudioPlayer?    

     func playBackgroundMusic(sound: String, type: String) {
        // 已有播放器实例则直接返回，不重复创建
        guard player == nil else { return }
        if let path = Bundle.main.path(forResource: sound, ofType: type) {
            do {
                player = try AVAudioPlayer(contentsOf: URL(fileURLWithPath: path))
                // 可选配置：开启背景音乐循环播放
                player?.numberOfLoops = -1
                player?.play()
            } catch {
                print("BACKGROUND MUSIC ERROR: \(error.localizedDescription)")
            }
        }
    }
}

如果需要支持切换不同背景音乐，可以先停止旧实例再创建新实例：

func playBackgroundMusic(sound: String, type: String) {
    // 先停止销毁旧实例
    if let existingPlayer = player {
        existingPlayer.stop()
        player = nil
    }
    // 后续创建新播放器的逻辑不变
}

方案2：修正视图模型修饰符 #

将 @ObservedObject 替换为 @StateObject，确保 AudioController 实例的生命周期和 ContentView 绑定，不会因视图重绘被反复创建：

struct ContentView: View {
    // 仅iOS14+支持@StateObject
    @StateObject var audioController = AudioController()

    var body: some View {
         Text("Hello, world!")
             .onAppear {
                 audioController.playBackgroundMusic(sound: "bg", type: "wav")
             }
    }
}

方案3：使用全局单例管理播放器 #

将 AudioController 设计为全局单例，全局仅存在一个实例，从根源避免多实例创建的问题：

class AudioController: ObservableObject {
    // 全局唯一实例
    static let shared = AudioController()
    var player: AVAudioPlayer?    

    // 私有化初始化方法，禁止外部创建新实例
    private init() {}

    func playBackgroundMusic(sound: String, type: String) {
        // 播放逻辑和方案1相同
    }
}

调用时直接使用单例即可，不需要在视图内创建实例：

.onAppear {
    AudioController.shared.playBackgroundMusic(sound: "bg", type: "wav")
}

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