SwiftUI多层控制器层级中ScrollView无法带动NavigationBar滚动动画问题

问题描述 #

初始控制器层级为 UINavigationController->UIHostingController->SwiftUIView，SwiftUIView内包含ScrollView，此时滚动ScrollView时，NavigationBar的透明度会随滚动正常变化。但在层级中新增一个UIViewController后，结构变为 UINavigationController->UIViewController->UIHostingController->SwiftUIView，ScrollView滚动时NavigationBar不再产生任何动画效果。尝试添加.padding(.top)可让NavigationBar正常显示，但仍无法响应滚动动作。

核心原因 #

UINavigationController的滚动联动逻辑仅针对其直接子控制器内的滚动视图生效。当新增的UIViewController成为导航控制器的直接子节点后，原SwiftUI ScrollView所在的UIHostingController变为二级子控制器，导航控制器无法感知到它的滚动事件，因此无法触发NavigationBar的透明度动画。

解决方案 #

方案1：中间层控制器传递滚动事件 #

在中间的UIViewController中，将UIHostingController内的ScrollView事件关联到导航控制器：

1. 找到UIHostingController视图层级中的UIScrollView实例
2. 将该ScrollView的代理设置为中间控制器，并手动同步滚动状态到导航控制器的NavigationBar

class MiddleViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        let hostingVC = UIHostingController(rootView: YourSwiftUIView())
        addChild(hostingVC)
        view.addSubview(hostingVC.view)
        hostingVC.view.frame = view.bounds
        hostingVC.didMove(toParent: self)
        
        // 定位ScrollView并关联到导航控制器
        if let scrollView = hostingVC.view.subviews.first(where: { $0 is UIScrollView }) as? UIScrollView {
            navigationController?.navigationBar.prefersLargeTitles = true
            scrollView.delegate = self
            scrollView.contentInsetAdjustmentBehavior = .automatic
        }
    }
}

extension MiddleViewController: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        // 同步滚动状态，触发NavigationBar动画
        navigationController?.navigationBar.setNeedsLayout()
    }
}

方案2：调整控制器层级结构 #

如果业务逻辑允许，优先保持UIHostingController作为UINavigationController的直接子控制器：

• 将原中间UIViewController的内容通过UIViewControllerRepresentable包装后嵌入到SwiftUIView中
• 或者调整业务流程，避免在导航控制器和UIHostingController之间插入额外的UIViewController

方案3：迁移到纯SwiftUI导航 #

若项目适配允许，使用SwiftUI的NavigationStack替代UIKit的UINavigationController，纯SwiftUI环境下ScrollView的滚动会自动和NavigationBar的动画联动，无需额外处理层级问题。

内容的提问来源于stack exchange，提问作者Vlad Z.