You need to enable JavaScript to run this app. easy_localization 2.3.3加载应用目录本地化文件 首启异常热重载正常
优惠活动
大模型
产品
解决方案
定价
更多

easy_localization 2.3.3加载应用目录本地化文件 首启异常热重载正常

问题根因

easy_localization 2.3.3 版本 默认的资源加载逻辑是通过Flutter的rootBundle读取打包在安装包里的Asset文件,会自动把传入的path参数拼接成Asset的相对路径去查找资源,完全不会主动读取应用私有目录(ApplicationDocumentsDirectory)下的文件。
冷启动阶段组件初始化时,因为没有替换默认加载器,库会把你传入的绝对路径 /data/user/0/com.example.app/app_flutter/localization/en-IN.json 当成Asset路径去rootBundle里查找,自然找不到对应资源,抛出Unable to load asset的错误。
热重载时组件会直接复用内存中已经缓存的本地化数据,不会重新走初始化的资源加载流程,所以功能临时恢复正常,直到下次冷启动重新触发初始化逻辑,问题复现。

修复方案
  • 先在main函数最开头完成Flutter绑定初始化,再异步获取应用目录路径,避免路径为空或读取时序错误
    void main() async {
      // 必须先执行这行,才能进行后续的异步文件操作
      WidgetsFlutterBinding.ensureInitialized();
      // 正确获取应用文档目录
      final appDocDir = await getApplicationDocumentsDirectory();
      final localizationDirPath = '${appDocDir.path}/localization';
    }
    
  • 替换默认的Asset加载器为库自带的文件系统加载器,绕开rootBundle的Asset查找逻辑
    初始化EasyLocalization时传入assetLoader参数,关闭默认的Asset兜底查找:
    EasyLocalization localization = EasyLocalization(
      path: localizationDirPath,
      supportedLocales:  [
        Locale('en', 'US'),
        Locale('en', 'IN'), // 把实际存储的对应文件的locale加入支持列表,解决文件和支持列表错配问题
        Locale('de', 'DE'),
        Locale('hi', 'IN')
      ],
      fallbackLocale: Locale('en', 'IN'),
      // 关键替换:用文件系统加载器替代默认的Asset加载器,禁止回退到Asset查找
      assetLoader: const FileAssetLoader(shouldFallbackToAsset: false),
      child: AppRootWidget()
    );
    runApp(localization);
    
  • 校验文件命名和路径匹配规则
    确保localization目录下的文件命名完全和库的默认查找规则一致,即{语言码}-{地区码}.json,比如en-IN.json对应Locale('en', 'IN'),不要出现文件命名和locale参数不匹配的情况。
  • 前置校验目标文件存在性
    在初始化EasyLocalization之前,提前判断对应语言的json文件是否已经写入完成,如果不存在则先执行文件生成逻辑,避免初始化时读取不到文件触发二次错误。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.13 12:06:04