SwiftUI与UIKit混合视图层级下内容尺寸传递异常求助

问题场景 #

我的视图层级是SwiftUI与UIKit混合结构：

AccordionView
  └─ VStack
     ├─ Text
     ├─ Button
     └─ UIViewRepresentable
        └─ UIStackView
           ├─ UILabel
           └─ UILabel

点击按钮可切换UIViewRepresentable内容的显隐，这部分功能正常，但特定场景下会出现异常：UILabel的框架尺寸显示正确（浅灰色背景、彩色边框可见），但文本却像拥有无限宽度一样单行显示，明明视图框架有足够空间支持换行渲染。

已整理出多种触发问题的配置，复现代码可在Swift Playground中查看。

排查后锁定可能的原因范围：

• HostedView和TextViewContainer未实现以下任一自动布局相关方法（按理解实现其一即可让栈视图正常工作）：
  • 实现intrinsicContentSize
  • 重写systemLayoutSizeFitting(_:)返回合适尺寸
• UIHostingController的intrinsic size使用存在问题（理论上它应该支持，但实际可能存在兼容问题）
• 可能与setContentCompressionResistancePriority()或setContentHuggingPriority()设置有关，但测试后暂未发现直接关联

解决方案 #

1. 给UIKit容器视图正确实现intrinsic内容尺寸 #

承载UIStackView的容器（比如TextViewContainer）必须正确返回intrinsicContentSize，让SwiftUI布局系统能准确计算其尺寸：

class TextViewContainer: UIView {
    let stackView = UIStackView()
    
    override var intrinsicContentSize: CGSize {
        // 直接返回内部栈视图的intrinsic尺寸
        stackView.intrinsicContentSize
    }
    
    // 当内部内容变化时，主动触发intrinsic尺寸更新
    func refreshLayout() {
        invalidateIntrinsicContentSize()
    }
}

2. 确保UILabel开启自动换行 #

不要遗漏UILabel的换行配置，避免强制单行显示：

func setupLabels() {
    let label1 = UILabel()
    label1.numberOfLines = 0 // 允许自动换行
    label1.lineBreakMode = .byWordWrapping // 按单词换行（可选.byCharWrapping）
    label1.setContentCompressionResistancePriority(.required, for: .vertical)
    
    let label2 = UILabel()
    label2.numberOfLines = 0
    label2.lineBreakMode = .byWordWrapping
    label2.setContentCompressionResistancePriority(.required, for: .vertical)
    
    stackView.addArrangedSubview(label1)
    stackView.addArrangedSubview(label2)
}

3. 调整UIViewRepresentable的布局约束优先级 #

在makeUIView方法中，给内部UIKit视图设置明确的压缩/抗拉伸优先级，确保SwiftUI能正确识别其布局需求：

struct MyUIViewRepresentable: UIViewRepresentable {
    var isContentHidden: Bool
    
    func makeUIView(context: Context) -> TextViewContainer {
        let container = TextViewContainer()
        container.stackView.axis = .vertical
        container.stackView.alignment = .leading
        container.setupLabels()
        
        // 设置垂直方向的优先级，避免被SwiftUI过度压缩
        container.stackView.setContentCompressionResistancePriority(.required, for: .vertical)
        container.stackView.setContentHuggingPriority(.defaultHigh, for: .vertical)
        return container
    }
    
    func updateUIView(_ uiView: TextViewContainer, context: Context) {
        uiView.isHidden = isContentHidden
        // 显隐切换后强制刷新布局
        if !isContentHidden {
            uiView.refreshLayout()
        }
    }
}

4. 修正UIHostingController的布局方式 #

如果是在UIKit中嵌入SwiftUI的UIHostingController，不要依赖其intrinsicContentSize来布局，而是给UIHostingController.view添加明确的约束，或者在SwiftUI侧通过frame修饰符限制最大宽度：

// SwiftUI侧给UIViewRepresentable添加最大宽度约束，确保文本有换行空间
MyUIViewRepresentable(isContentHidden: $isHidden)
    .frame(maxWidth: .infinity, alignment: .leading)

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