Flutter Web报错：请勿手动调用didCreateEngineInitializer

问题详情 #

在Chrome浏览器运行Flutter应用时触发以下错误：

Do not call didCreateEngineInitializer by hand. Start with loadEntrypoint instead.
TypeError: this._didCreateEngineInitializerResolve is not a function

当前Flutter环境信息：

[✓] Flutter (Channel stable, 3.3.1, on macOS 12.4 21F79 darwin-x64, locale en-GB)
    • Flutter version 3.3.1 on channel stable at /Users/urvashikharecha/Desktop/FlutterSDKs/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 4f9d92fbbd (7 days ago), 2022-09-06 17:54:53 -0700
    • Engine revision 3efdf03e73
    • Dart version 2.18.0
    • DevTools version 2.15.0

错误界面：

解决步骤 #

1. 修复Web入口初始化代码 #

这个错误源于Flutter 3.x版本对Web端初始化逻辑的调整，禁止手动调用didCreateEngineInitializer，需改用loadEntrypoint：

• 打开项目根目录下的web/index.html文件
• 找到Flutter初始化的JavaScript代码，将旧的调用方式替换为新写法：

旧代码示例：

_flutter.loader.didCreateEngineInitializer().then(function(engineInitializer) {
  engineInitializer.initializeEngine().then(function(appRunner) {
    appRunner.runApp();
  });
});

新代码：

_flutter.loader.loadEntrypoint({
  onEntrypointLoaded: async function(engineInitializer) {
    const appRunner = await engineInitializer.initializeEngine();
    await appRunner.runApp();
  }
});

2. 清理缓存并重新构建 #

修改完成后执行以下命令清理缓存并重新运行：

flutter clean
flutter pub get
flutter run -d chrome

3. 升级Flutter到最新稳定版（可选） #

如果上述操作无效，尝试升级Flutter到最新稳定版本，确保环境与Web初始化逻辑兼容：

flutter channel stable
flutter upgrade

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