iOS16下UIViewControllerRepresentable旋转时viewDidLayoutSubviews多次调用如何解决？

问题确认 #

这是iOS16中SwiftUI与UIKit交互时的已知布局bug：当通过UIViewControllerRepresentable封装UIViewController时，设备旋转过程中viewDidLayoutSubviews会被频繁触发（伴随视图边界的持续变化），而纯UIKit环境下该方法仅在旋转前后各调用一次。iOS17中苹果修复了该问题的大部分影响，但在需要兼容iOS16的场景下，需针对性处理。

复现代码如下：

class ViewController: UIViewController {
    override func viewDidLayoutSubviews() {
        print("viewDidLayoutSubviews: \(self.view.bounds)")
    }
}

struct Representable: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> ViewController {
        return ViewController()
    }

    func updateUIViewController(_ uiViewController: ViewController, context: Context) {
        
    }
}

struct ContentView: View {
    var body: some View {
        Representable()
    }
}

解决办法 #

1. 过滤微小布局变化，仅处理有效更新 #

在UIViewController中记录上一次的视图边界，只有当边界变化超过阈值时才执行核心布局逻辑，忽略旋转动画过程中的频繁微小更新：

class ViewController: UIViewController {
    private var lastValidBounds: CGRect = .zero
    // 阈值可根据需求调整，1pt足够过滤动画过程中的渐变变化
    private let layoutThreshold: CGFloat = 1
    
    override func viewDidLayoutSubviews() {
        super.viewDidLayoutSubviews()
        
        let currentBounds = view.bounds
        let widthChanged = abs(currentBounds.width - lastValidBounds.width) > layoutThreshold
        let heightChanged = abs(currentBounds.height - lastValidBounds.height) > layoutThreshold
        
        guard widthChanged || heightChanged else {
            return
        }
        
        lastValidBounds = currentBounds
        // 此处执行你的滚动视图布局逻辑
        print("有效布局更新: \(lastValidBounds)")
    }
}

2. 调整UIKit视图的布局控制权 #

让UIViewController的视图自主管理布局约束，减少SwiftUI的自动布局干预：

struct Representable: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> ViewController {
        let vc = ViewController()
        // 禁用SwiftUI对该视图的自动约束生成，交由UIKit管理
        vc.view.translatesAutoresizingMaskIntoConstraints = true
        return vc
    }

    func updateUIViewController(_ uiViewController: ViewController, context: Context) {
        
    }
}

struct ContentView: View {
    var body: some View {
        // 让Representable占满父视图，避免布局冲突
        Representable()
            .frame(maxWidth: .infinity, maxHeight: .infinity)
    }
}

3. 监听旋转通知，在动画结束后执行布局 #

通过监听设备旋转通知，延迟执行布局逻辑，确保仅在旋转动画完成后处理最终布局：

class ViewController: UIViewController {
    // 供外部调用的最终布局方法
    func applyFinalLayout() {
        print("旋转完成后布局: \(view.bounds)")
        // 执行滚动视图的缩放、位置调整等核心逻辑
    }
}

struct Representable: UIViewControllerRepresentable {
    class Coordinator: NSObject {
        weak var viewController: ViewController?
        
        override init() {
            super.init()
            NotificationCenter.default.addObserver(
                self,
                selector: #selector(handleRotationComplete),
                name: UIDevice.orientationDidChangeNotification,
                object: nil
            )
        }
        
        @objc private func handleRotationComplete() {
            // 延迟0.3秒，确保旋转动画完全结束
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
                self.viewController?.applyFinalLayout()
            }
        }
        
        deinit {
            NotificationCenter.default.removeObserver(self)
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
    
    func makeUIViewController(context: Context) -> ViewController {
        let vc = ViewController()
        context.coordinator.viewController = vc
        return vc
    }

    func updateUIViewController(_ uiViewController: ViewController, context: Context) {
        
    }
}

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