从UIKit展示嵌入Hosting Controller的SwiftUI视图时出现过渡白线求助

问题场景 #

我有一个名为PaywallView的SwiftUI视图，通过UIKit视图控制器用以下代码创建并展示：

let paywallView = PaywallView()
let hostingController = UIHostingController(rootView: paywallView)
hostingController.modalPresentationStyle = .fullScreen
self.present(hostingController, animated: true)

运行整体符合预期，但在展示过渡/动画期间会出现细水平白线，动画完成后该白线消失：

• 过渡期间：屏幕顶部出现一条细水平白线
• 过渡完成后：白线消失，视图显示正常

补充说明：该SwiftUI视图中无导航栏、NavigationView或NavigationStack。

问题原因 #

这种白线是UIKit和SwiftUI视图层级在动画过渡时的渲染对齐误差导致的——UIKit的模态动画逻辑与SwiftUI的视图渲染在帧同步上出现微小偏差，使得底层视图的边缘在动画过程中短暂暴露出来。

解决方法 #

以下是几种经过验证的可行方案：

方案1：给HostingController的View设置匹配背景色 #

创建UIHostingController后，直接将其view的背景色设置为和PaywallView主背景色一致，避免底层视图边缘暴露：

let paywallView = PaywallView()
let hostingController = UIHostingController(rootView: paywallView)
hostingController.modalPresentationStyle = .fullScreen
// 替换成你PaywallView实际使用的背景色
hostingController.view.backgroundColor = .black
self.present(hostingController, animated: true)

方案2：给SwiftUI视图添加边缘扩展 #

在PaywallView外层包裹带背景的容器，让视图超出屏幕范围一点，覆盖可能出现的渲染间隙：

struct PaywallView: View {
    var body: some View {
        ZStack {
            // 你的原有视图内容
        }
        .background(Color.black) // 匹配你的主背景色
        .edgesIgnoringSafeArea(.all)
        // 扩展边缘，确保覆盖可能的间隙
        .frame(minWidth: UIScreen.main.bounds.width + 2, minHeight: UIScreen.main.bounds.height + 2)
    }
}

方案3：调整模态过渡的视图层级（针对特定系统版本） #

部分iOS版本中，模态过渡的半透明效果会加剧渲染偏差，可通过代理方法调整视图层级：

// 创建HostingController时设置代理
let hostingController = UIHostingController(rootView: paywallView)
hostingController.modalPresentationStyle = .fullScreen
hostingController.presentationController?.delegate = self

// 在当前UIKit视图控制器中实现代理方法
extension YourViewController: UIAdaptivePresentationControllerDelegate {
    func presentationController(_ presentationController: UIPresentationController, shouldRemovePresentersView: Bool) -> Bool {
        return true
    }
}

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