SwiftUI嵌入Storyboard项目后页面空白问题求助

在Xcode 13.2.1环境下，将SwiftUI视图嵌入现有或新建的Storyboard项目时，跳转至托管SwiftUI的PokeViewController后页面显示空白，但项目其他功能（如ImagePicker）可正常运行，核心问题在于UIHostingController的生命周期关联和布局约束未正确设置。

现有代码问题分析 #

你的PokeViewController仅完成了添加子控制器和子视图的基础操作，缺少两个关键步骤：

1. 未设置子视图布局约束，导致SwiftUI视图无尺寸，无法显示
2. 未完成子控制器的生命周期绑定，SwiftUI视图无法正确渲染

修正后的代码 #

import UIKit
import SwiftUI

class PokeViewController: UIViewController {

    @IBOutlet weak var theContainer: UIView!
    
    override func viewDidLoad() {
        super.viewDidLoad()

        let hostingController = UIHostingController(rootView: SwiftUIView())
        addChild(hostingController)
        
        // 禁用自动约束转换，手动设置布局
        hostingController.view.translatesAutoresizingMaskIntoConstraints = false
        theContainer.addSubview(hostingController.view)
        
        // 添加约束让SwiftUI视图完全填充容器
        NSLayoutConstraint.activate([
            hostingController.view.topAnchor.constraint(equalTo: theContainer.topAnchor),
            hostingController.view.leadingAnchor.constraint(equalTo: theContainer.leadingAnchor),
            hostingController.view.trailingAnchor.constraint(equalTo: theContainer.trailingAnchor),
            hostingController.view.bottomAnchor.constraint(equalTo: theContainer.bottomAnchor)
        ])
        
        // 完成子控制器生命周期关联
        hostingController.didMove(toParent: self)
    }
}

关键步骤说明 #

• translatesAutoresizingMaskIntoConstraints = false：关闭UIKit自动生成的约束，避免和手动添加的约束冲突
• 四边约束：确保UIHostingController的视图完全贴合容器边界，获得正确的显示尺寸
• didMove(toParent: self)：告知UIKit子控制器已完成添加，触发SwiftUI视图的初始化和渲染流程

额外检查项 #

• 确认Storyboard中theContainer容器视图已正确关联到代码的IBOutlet（可在viewDidLoad中打印theContainer，确认不为nil）
• 检查SwiftUI视图内容是否存在隐藏或透明设置
• 确保跳转至PokeViewController时，是通过Storyboard segue或instantiateViewController(withIdentifier:)正确初始化的

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