Swift类调用mutating协议扩展方法触发“self不可变”错误的原因

你遇到的错误核心在于Swift对协议mutating方法的处理逻辑：

1. 你的协议CanPlayMusic没有限制仅类遵循，编译器默认它可能被**值类型（结构体/枚举）**遵循，因此扩展里的mutating关键字是为值类型设计的——值类型必须通过mutating才能修改自身属性。
2. 对于类（引用类型）来说，实例方法默认可以修改自身属性，不需要mutating关键字。但当类调用协议扩展里的mutating方法时，编译器会因为协议兼容值类型，统一将self视为不可变的实例（等价于值类型的let实例），哪怕你调用的是类的实例方法，self在这里被当成了不可变的"值"，从而抛出Cannot use mutating member on immutable value错误。

根据你同时支持UIKit类和SwiftUI视图的需求，提供两种可行方案：

方案一：将协议限制为类专属（推荐，若无需结构体遵循） #

如果你的协议只需要被类（比如UIViewController、SwiftUI的ObservableObject子类）遵循，直接让协议继承AnyObject（Swift 3+推荐，等价于旧的class关键字），编译器会明确协议仅适用于引用类型，扩展里的方法无需mutating关键字：

import AVFoundation

protocol CanPlayMusic: AnyObject {
    var player: AVAudioPlayer! { get set }
}

extension CanPlayMusic {
    // 移除所有mutating关键字
    func playMusic(file url: URL, loops: Int = -1) {
        player = try! AVAudioPlayer(contentsOf: url)
        player.numberOfLoops = loops
        player.play()
    }
    
    func playIntroMusic() {
        let file = Assets.Music.chargeDeBurkel
        let ext = Assets.Music.ext
        guard let url = Bundle.main.url(forResource: file,
                                        withExtension: ext) else { return }
        
        playMusic(file: url)
    }
    
    func playGameOverMusic(isWinning: Bool) {
        guard let lose = Bundle.main.url(forResource: Assets.Music.taps,
                                         withExtension: Assets.Music.ext),
              let win  = Bundle.main.url(forResource: Assets.Music.reveille,
                                         withExtension: Assets.Music.ext)
        else { return }
        
        playMusic(file: isWinning ? win : lose, loops: 1)
    }
}

修改后，类调用playIntroMusic()就不会再报错。

方案二：保留协议兼容值类型，调整类中调用方式 #

如果必须让协议支持结构体（比如SwiftUI的View结构体），可以保留mutating关键字，在类调用时将self转为可变引用：

override func viewDidLoad() {
    var mutableSelf = self
    mutableSelf.playIntroMusic() // 此处无报错
    startButton.setTitle("", for: .normal)
    getCurrency()
}

原理是把类方法中默认不可变的self（let引用）赋值给var变量，编译器会将其识别为可变实例，允许调用mutating方法。

SwiftUI的View是值类型，若让其遵循CanPlayMusic，确实需要mutating方法修改player属性；而UIKit的ViewController是引用类型，无需mutating。如果需要同时兼容两者，方案二可以满足，但方案一更简洁——你也可以把SwiftUI的音乐播放逻辑放到ObservableObject类中，让类遵循协议，避免在结构体中处理mutating逻辑。

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