iOS 16中SwiftUI视图嵌入UIViewController时SafeArea失效问题

问题重现 #

将SwiftUI视图通过UIHostingController嵌入标准UIViewController时，iOS 15下视图会自动适配SafeArea，但iOS 16中SafeArea被忽略，视图直接顶到屏幕边缘。相关代码如下：

ViewController代码

override func viewDidLoad() {
    super.viewDidLoad()
    let myview = UIHostingController(rootView: MyView())
    view.addSubview(myview.view)
    myview.view.frame = view.frame
}

SwiftUI视图代码

struct MyView: View {
    var body: some View {
        VStack {
            HStack{
                Spacer()
                Text("lol")
                    .font(.title)
                    .padding()
                    .background(Color.red)
            }
            Spacer()
        }
    }
}

核心问题 #

1. 直接设置frame = view.frame未关联父视图的safeAreaLayoutGuide，iOS 16对UIHostingController的布局上下文校验更严格；
2. 未正确处理子视图控制器生命周期（缺少addChild和didMove(toParent:)调用），导致布局环境未正确初始化。

解决方案 #

方案1：通过Auto Layout绑定到SafeArea

使用约束将UIHostingController的视图绑定到父视图的safeAreaLayoutGuide，同时正确处理子控制器生命周期：

override func viewDidLoad() {
    super.viewDidLoad()
    let hostingController = UIHostingController(rootView: MyView())
    
    // 正确添加子控制器
    addChild(hostingController)
    view.addSubview(hostingController.view)
    hostingController.view.translatesAutoresizingMaskIntoConstraints = false
    
    // 绑定到SafeArea约束
    NSLayoutConstraint.activate([
        hostingController.view.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        hostingController.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        hostingController.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        hostingController.view.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
    ])
    
    hostingController.didMove(toParent: self)
}

方案2：配置edgesForExtendedLayout并绑定父视图边缘

如果需要让UIHostingController的视图填充整个父视图，但SwiftUI内部自动适配SafeArea，可以设置edgesForExtendedLayout = []：

override func viewDidLoad() {
    super.viewDidLoad()
    let hostingController = UIHostingController(rootView: MyView())
    
    // 禁止视图延伸到SafeArea外
    hostingController.edgesForExtendedLayout = []
    
    addChild(hostingController)
    view.addSubview(hostingController.view)
    hostingController.view.translatesAutoresizingMaskIntoConstraints = false
    
    NSLayoutConstraint.activate([
        hostingController.view.topAnchor.constraint(equalTo: view.topAnchor),
        hostingController.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        hostingController.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        hostingController.view.bottomAnchor.constraint(equalTo: view.bottomAnchor)
    ])
    
    hostingController.didMove(toParent: self)
}

同时可在SwiftUI视图中显式添加SafeArea padding增强兼容性：

struct MyView: View {
    var body: some View {
        VStack {
            HStack{
                Spacer()
                Text("lol")
                    .font(.title)
                    .padding()
                    .background(Color.red)
            }
            Spacer()
        }
        .safeAreaPadding(.top) // 显式添加顶部SafeArea内边距
    }
}

原因说明 #

iOS 16调整了UIHostingController的布局默认行为，不再自动继承父视图的SafeArea配置。必须通过显式约束关联到safeAreaLayoutGuide，或者配置edgesForExtendedLayout控制视图延伸范围，同时正确处理子控制器生命周期，才能让SwiftUI视图正确识别SafeArea。

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