嵌入SwiftUI的Flutter SingleChildScrollView无法滚动问题求助

问题场景 #

团队正从原生SwiftUI应用迁移至Flutter，当前同时维护两个项目：部分功能由Flutter开发并编译为.xcframework导入SwiftUI项目使用。某Flutter视图采用SingleChildScrollView承载内容，单独运行Flutter项目（模拟器/真机）时滚动正常，但将该视图嵌入SwiftUI的sheet后，滚动功能完全失效，内容无法滑动。已验证独立Flutter应用滚动正常、.xcframework集成无误、尝试过不同SwiftUI展示样式，问题仍存在。

可行解决方案 #

1. 给SwiftUI中的Flutter视图添加明确尺寸约束 #

SwiftUI的sheet可能会给嵌入的Flutter视图设置模糊的尺寸约束，导致SingleChildScrollView无法正确计算滚动区域。需为Flutter视图指定明确的尺寸范围：

struct FlutterSheetContentView: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> FlutterViewController {
        // 替换为你的Flutter引擎实例
        let flutterVC = FlutterViewController(engine: AppFlutterEngine.shared, nibName: nil, bundle: nil)
        return flutterVC
    }
    
    func updateUIViewController(_ uiViewController: FlutterViewController, context: Context) {}
}

// 调用sheet时设置frame
.sheet(isPresented: $showFlutterSheet) {
    FlutterSheetContentView()
        .frame(maxWidth: .infinity, maxHeight: .infinity)
}

2. 强制启用Flutter滚动视图的滚动物理特性 #

部分场景下，外部容器的约束会导致Flutter滚动视图自动禁用滚动，可通过AlwaysScrollableScrollPhysics()强制启用：

SingleChildScrollView(
  physics: const AlwaysScrollableScrollPhysics(), // 强制开启滚动
  child: Column(
    children: [
      // 确保内容总高度超过容器高度，触发滚动
      ...
    ],
  ),
)

3. 处理SwiftUI Sheet与Flutter的手势冲突 #

SwiftUI的sheet自带下拉关闭手势，可能与Flutter的滚动手势产生冲突。可先禁用sheet的默认交互手势：

.sheet(isPresented: $showFlutterSheet) {
    FlutterSheetContentView()
        .interactiveDismissDisabled() // 禁用下拉关闭手势
}

若需要保留下拉关闭功能，可在Flutter端通过手势抢占优先级：

GestureDetector(
  behavior: HitTestBehavior.opaque,
  onVerticalDragDown: (_) {}, // 优先捕获垂直手势
  child: SingleChildScrollView(
    child: // 你的内容
  ),
)

4. 确保Flutter引擎初始化完成后再嵌入视图 #

如果Flutter引擎未完全初始化就嵌入视图，可能导致交互功能异常。需等待引擎就绪后再展示Flutter视图：

struct FlutterSheetContentView: UIViewControllerRepresentable {
    @State private var engineReady = false
    
    func makeUIViewController(context: Context) -> UIViewController {
        let placeholderVC = UIViewController()
        
        if AppFlutterEngine.shared.isRunning {
            engineReady = true
            return FlutterViewController(engine: AppFlutterEngine.shared, nibName: nil, bundle: nil)
        } else {
            AppFlutterEngine.shared.run()
            AppFlutterEngine.shared.initializationCompleteHandler = { _ in
                DispatchQueue.main.async {
                    self.engineReady = true
                }
            }
            return placeholderVC
        }
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {
        if engineReady {
            let flutterVC = FlutterViewController(engine: AppFlutterEngine.shared, nibName: nil, bundle: nil)
            uiViewController.present(flutterVC, animated: false)
        }
    }
}

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