You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter 3.22.0升级后FlutterLoader.load报错问题求助

解决Flutter 3.22.0中FlutterLoader.load的buildConfig问题

Flutter 3.22.0对Web端的初始化逻辑做了重构,废弃loadEntrypoint后,新的load函数要求明确传入构建配置信息,这就是你遇到_flutter.buildConfig提示的原因。以下是具体解决办法:

方法一:用Flutter自动生成的初始化代码

如果你的项目是通过标准flutter create创建的,直接重新执行flutter build web,构建后会自动更新index.html里的初始化脚本,以及对应的flutter.js和main.dart.js。生成的代码会自动正确传入buildConfig,无需手动修改。

方法二:手动修改初始化代码(自定义场景)

如果需要自定义初始化逻辑,按以下步骤操作:

  • 先获取正确的buildConfig:可以从重新构建后自动生成的index.html中提取,或者参考构建输出的配置信息,它包含入口文件路径、资源目录等关键信息。
  • 调用load函数时传入完整配置,示例代码如下:
    const loader = window.flutter_loader;
    loader.load({
      buildConfig: {
        entrypoint: "main.dart.js",
        assets: "assets",
        flutterVersion: "3.22.0",
        // 其他字段根据项目实际构建结果补充
      },
      onEntrypointLoaded: async (engineInitializer) => {
        const appRunner = await engineInitializer.initializeEngine();
        await appRunner.runApp();
      }
    });
    
  • 注意:buildConfig的字段必须和项目实际构建后的文件结构、版本匹配,最好直接复制自动生成的配置内容,避免手动配置出错。

注意事项

  • buildConfig是load函数的必填参数,不可省略,它是Flutter引擎定位资源和启动入口的关键依据。
  • 如果自定义了资源目录或入口文件名,一定要同步修改buildConfig里的对应字段。

内容的提问来源于stack exchange,提问作者Mori

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.24 01:26:00