SwiftUI中UIViewRepresentable初始化器报错：未覆盖父类指定初始化器

错误原因 #

你给PlayerUIView的初始化器加了override关键字，但UIView的指定初始化器只有init(frame:)和init(coder:)，根本不存在init(frame:videoResource:)这个父类方法。override只能用来重写父类已有的方法/初始化器，所以编译器报错。

解决方案一：自定义初始化器（移除override） #

直接去掉override，创建自定义初始化器，内部调用父类的指定初始化器super.init(frame: frame)即可：

class PlayerUIView: UIView {
      
    private var playerLayer = AVPlayerLayer()
    private var playerLooper: AVPlayerLooper?

    // 移除override，自定义初始化器
    init(frame: CGRect, videoResource: String) {
        super.init(frame: frame)
        setupVideoPlayer(with: videoResource)
    }

    // 把播放器初始化逻辑抽成单独方法，代码更清晰
    private func setupVideoPlayer(with resource: String) {
        guard let fileURL = Bundle.main.url(forResource: resource, withExtension: "mp4") else {
            fatalError("无法找到指定视频资源")
        }
        let playerItem = AVPlayerItem(url: fileURL)
        let player = AVQueuePlayer(playerItem: playerItem)

        playerLayer.player = player
        playerLayer.videoGravity = .resizeAspectFill
        playerLayer.backgroundColor = UIColor.white.cgColor
        layer.addSublayer(playerLayer)

        playerLooper = AVPlayerLooper(player: player, templateItem: playerItem)
        player.play()
    }

    override func layoutSubviews() {
        super.layoutSubviews()
        playerLayer.frame = bounds
    }

    required init(coder: NSCoder) {
        fatalError("init(coder: ) has not been implemented")
    }
}

对应的VideoPlayerView不需要修改，原代码可以正常调用这个自定义初始化器。

解决方案二：拆分初始化与配置（更灵活） #

如果后续需要支持动态更新视频资源，可以把资源配置逻辑抽成单独方法，用默认的init(frame:)初始化视图后再调用配置：

class PlayerUIView: UIView {
      
    private var playerLayer = AVPlayerLayer()
    private var playerLooper: AVPlayerLooper?
    private(set) var currentResource: String?

    override init(frame: CGRect) {
        super.init(frame: frame)
    }

    // 配置视频资源的方法
    func configureVideo(with resource: String) {
        guard let fileURL = Bundle.main.url(forResource: resource, withExtension: "mp4") else {
            fatalError("无法找到指定视频资源")
        }
        // 先停止之前的播放（如果有）
        playerLayer.player?.pause()
        playerLooper = nil

        let playerItem = AVPlayerItem(url: fileURL)
        let player = AVQueuePlayer(playerItem: playerItem)

        playerLayer.player = player
        playerLayer.videoGravity = .resizeAspectFill
        playerLayer.backgroundColor = UIColor.white.cgColor
        layer.addSublayer(playerLayer)

        playerLooper = AVPlayerLooper(player: player, templateItem: playerItem)
        player.play()
        currentResource = resource
    }

    override func layoutSubviews() {
        super.layoutSubviews()
        playerLayer.frame = bounds
    }

    required init(coder: NSCoder) {
        fatalError("init(coder: ) has not been implemented")
    }
}

修改VideoPlayerView来适配这个方案：

struct VideoPlayerView: UIViewRepresentable {

    let resource: String

    func makeUIView(context: Context) -> PlayerUIView {
        let view = PlayerUIView(frame: CGRect(x: 0, y: 0, width: 200, height: 200))
        view.configureVideo(with: resource)
        return view
    }

    func updateUIView(_ uiView: PlayerUIView, context: Context) {
        // 当资源变化时更新视频
        if uiView.currentResource != resource {
            uiView.configureVideo(with: resource)
        }
    }
}

总结 #

• 只有重写父类已有的方法/初始化器时才需要override关键字，自定义方法/初始化器不需要加
• 自定义初始化器必须调用父类的指定初始化器（比如super.init(frame:)）
• 如果需要动态更新UI内容，第二种拆分初始化与配置的方案更适合SwiftUI的生命周期

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