iOS 26下UIKit嵌入UIHostingController缩放时SwiftUI文本异常排查

问题背景 #

开发了一款基于UIKit的iOS看板编辑器应用，每个看板项为UIView，其中note、date、calendar、countdown类型项通过UIHostingController将SwiftUI内容嵌入UIView中展示。该功能在iOS 18上运行正常，但在iOS 26中，捏合缩放看板项时，托管SwiftUI视图内的文本会改变大小/位置；部分新添加的项甚至未缩放就已出现字体大小/位置错误。

关键异常特征 #

• 主屏幕小组件渲染正常
• 看板列表缩略图快照显示正常
• 仅在看板编辑界面出现该问题
• 问题仅出现在通过CGAffineTransform交互式缩放的、嵌入UIHostingController的UIKit视图路径中

简化代码实现 #

HostedSwiftUIView 代码 #

final class HostedSwiftUIView: UIView {
    private var hostingController: UIHostingController<AnyView>?
    private var pendingRoot: AnyView?

    func setSwiftUIContent<Content: View>(_ content: Content) {
        let root = AnyView(content.ignoresSafeArea(.keyboard))
        pendingRoot = root

        if let hc = hostingController {
            hc.rootView = root
            hc.view.setNeedsLayout()
            hc.view.layoutIfNeeded()
            return
        }

        let hc = UIHostingController(rootView: root)
        hc.view.backgroundColor = .clear

        if #available(iOS 16.0, *) {
            hc.sizingOptions = []
        }

        addSubview(hc.view)
        hc.view.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            hc.view.leadingAnchor.constraint(equalTo: leadingAnchor),
            hc.view.trailingAnchor.constraint(equalTo: trailingAnchor),
            hc.view.topAnchor.constraint(equalTo: topAnchor),
            hc.view.bottomAnchor.constraint(equalTo: bottomAnchor)
        ])

        hostingController = hc
    }

    override func layoutSubviews() {
        super.layoutSubviews()
        hostingController?.view.setNeedsLayout()
        hostingController?.view.layoutIfNeeded()
    }

    override func didMoveToWindow() {
        super.didMoveToWindow()
        guard let hc = hostingController,
              window != nil,
              hc.parent == nil,
              let parentVC = nearestViewController()
        else { return }

        parentVC.addChild(hc)
        hc.didMove(toParent: parentVC)

        if pendingRoot != nil {
            DispatchQueue.main.async { [weak self, weak hc] in
                guard let self, let hc, let latestRoot = self.pendingRoot else { return }
                hc.rootView = latestRoot
                hc.view.setNeedsLayout()
                hc.view.layoutIfNeeded()
            }
        }
    }

    private func nearestViewController() -> UIViewController? {
        var responder: UIResponder? = next
        while let r = responder {
            if let vc = r as? UIViewController { return vc }
            responder = r.next
        }
        return nil
    }
}

BoardItemView 代码 #

final class BoardItemView: UIView {
    private let contentContainer = UIView()
    private var visualScale: CGFloat = 1
    private var visualRotation: CGFloat = 0

    func setContent(_ view: UIView) {
        contentContainer.subviews.forEach { $0.removeFromSuperview() }
        contentContainer.addSubview(view)
        view.frame = contentContainer.bounds
        view.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.setNeedsLayout()
        view.layoutIfNeeded()
    }

    func applyTransform(scale: CGFloat, rotation: CGFloat) {
        visualScale = scale
        visualRotation = rotation
        contentContainer.transform =
            CGAffineTransform(rotationAngle: rotation)
                .scaledBy(x: scale, y: scale)
    }
}

注：托管控制器的viewDidLayoutSubviews路径会在重新布局后触发刷新

iOS 26 症状 #

• 捏合操作会导致托管SwiftUI视图内的文本重排/改变字体大小
• 松开手势后文本可能停留在错误的大小/位置
• 添加新项可能导致现有文本项缩小
• 小组件和快照渲染无此问题

核心问题 #

1. 在iOS新版本中，将UIHostingController视图嵌入UIKit并通过CGAffineTransform缩放时，是否存在已知的渲染/布局差异？
2. 在变换期间/之后反复调用hosting view的layoutIfNeeded()是否会触发SwiftUI文本重新测量？
3. 推荐的修复方案是否是避免直接变换托管SwiftUI视图，而是选择以下方案之一：
   • 变换快照/光栅化图层
   • 让SwiftUI视图处于稳定布局空间，仅缩放外部非托管容器
   • 为这些文本密集型项切换到纯SwiftUI编辑器路径？

注：寻求架构级修复方案，而非针对单一文本样式的临时解决方法

解决方案与分析 #

1. iOS新版本已知差异确认 #

是的，iOS 17及后续版本（包括iOS 26）在UIHostingController与CGAffineTransform结合的场景下，存在布局与渲染的行为变更。SwiftUI的文本布局系统对容器视图的变换敏感度显著提升，当UIKit通过transform缩放托管视图时，SwiftUI会错误地将变换后的视觉尺寸视为布局空间的实际变化，触发文本重排与字体大小调整——这在iOS 18及更早版本中不会发生，因为旧版本SwiftUI对UIKit层的transform具备更好的隔离性。

2. layoutIfNeeded()对文本测量的影响 #

反复调用layoutIfNeeded()确实会触发SwiftUI的文本重新测量。SwiftUI的布局系统依赖于视图的intrinsicContentSize和父容器约束，而UIHostingController的layoutIfNeeded()会强制SwiftUI重新计算布局逻辑。当外部有CGAffineTransform作用时，SwiftUI可能误将transform后的视觉尺寸当作布局约束的输入参数，导致文本重新计算大小与位置。

3. 架构级修复方案推荐 #

优先方案：让SwiftUI视图处于稳定布局空间，仅缩放外部非托管容器

这是对现有架构改动最小且最稳定的方案：

• 修改BoardItemView的结构，新增一个专门的视觉缩放容器，将contentContainer作为子视图添加到该容器中；
• 将applyTransform方法中的CGAffineTransform应用到这个新的视觉缩放容器上，而非直接作用于包含SwiftUI视图的contentContainer；
• 确保HostedSwiftUIView始终处于原始布局尺寸（未被transform修改），SwiftUI的文本布局将基于真实约束计算，不受视觉缩放影响。

备选方案：变换快照/光栅化图层

适合不需要交互的静态内容：

• 对SwiftUI视图生成快照（使用UIGraphicsImageRenderer），将快照作为UIImageView显示；
• 对UIImageView应用CGAffineTransform，避免SwiftUI布局系统受transform干扰；
• 缺点是会丢失SwiftUI视图的交互能力，仅适合纯展示型看板项。

彻底方案：切换到纯SwiftUI编辑器路径

将看板编辑界面整体迁移到SwiftUI：

• 使用SwiftUI原生的scaleEffect和rotationEffect替代UIKit的CGAffineTransform；
• SwiftUI的变换系统是布局感知的，不会导致文本布局错误，同时能统一整个编辑器的技术栈，减少跨框架兼容问题；
• 适合长期维护的项目，可彻底消除UIKit与SwiftUI混合带来的兼容性问题。

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