iOS原生APP集成Flutter模块：shared_preferences初始化报channel-error异常

云上老周

2026-7-26

解决方案

问题根源

在ViewController中重复调用flutterEngine.run()，AppDelegate已完成引擎初始化与插件注册，重复执行会导致引擎内部状态混乱，平台通道无法正常建立。
新建的FlutterViewController未关联已初始化的引擎实例，导致其使用未注册插件的新引擎，调用SharedPreferences时触发通道错误。

修改步骤

1. 修正ViewController.swift的`goToFlutterPage`方法

移除重复的引擎启动调用，改用已初始化的引擎创建Flutter视图控制器：

@IBAction func goToFlutterPage(_ sender: Any) {
    api.syncDataToFlutter(user: user) {
        // 关联已初始化的引擎实例
        let flutterViewController = FlutterViewController(engine: self.flutterEngine, nibName: nil, bundle: nil)
        self.present(flutterViewController, animated: true, completion: nil)
    }
}

2. 简化API初始化逻辑

无需在goToFlutterPage中重复初始化API，保留viewDidLoad中的单次初始化即可：

let flutterEngine = (UIApplication.shared.delegate as! AppDelegate).flutterEngine
var api: NativeDataSaveToFlutterAPI!

override func viewDidLoad() {
    super.viewDidLoad()
    // 仅初始化一次API
    api = NativeDataSaveToFlutterAPI(binaryMessenger: flutterEngine.binaryMessenger)
}

原理说明

AppDelegate中预初始化的flutterEngine已通过GeneratedPluginRegistrant完成所有插件（包括shared_preferences）的注册，复用该实例可保证平台通道连接正常。
使用FlutterViewController(engine: ...)构造方法，会直接关联已有引擎，而非创建新实例，确保Flutter代码调用SharedPreferences.getInstance()时能找到正确的平台通道。