Flutter读取assets目录XML文件报找不到文件或空指针错误如何解决？

第一个错误（FileSystemException: No such file or directory） #

Flutter项目中的assets资源属于编译后打包到安装包内的内置资源，不存在于设备的本地文件系统路径中，File类是用于访问设备本地存储文件的API，无法直接读取打包后的内置资源，因此会抛出路径不存在的错误，即使用readAsLines、readAsStringSync等同属File类的方法也无法解决。

第二个错误（Null check operator used on a null value） #

使用rootBundle读取资源时报空指针，常见原因有以下几种：

• 未导入flutter/services.dart依赖包，导致rootBundle调用异常
• pubspec.yaml中assets配置格式错误：YAML对缩进要求严格，assets节点必须位于flutter节点下，每个路径的缩进层级必须正确，多/少空格都会导致资源配置失效
• 调用读取方法时Flutter框架还未完成初始化，rootBundle实例未生成
• 资源路径和实际文件路径不一致：包括大小写不匹配、文件名/目录名拼写错误、后缀名不符
• 资源未被正确打包：修改pubspec后未执行flutter pub get，或未重新编译运行项目

按以下步骤逐一排查修复即可：

1. 导入必要依赖：在代码文件顶部加入import 'package:flutter/services.dart';
2. 校验pubspec.yaml配置：确保配置格式符合要求，示例如下：

flutter:
  uses-material-design: true
  # assets节点和uses-material-design平级，缩进2个空格
  assets:
    # 单个资源路径，再缩进2个空格
    - assets/xml_file/belovedskincare.xml
    # 也可以直接配置整个目录，注意末尾带斜杠
    # - assets/xml_file/

配置完成后必须执行flutter pub get，然后重新编译运行项目，避免缓存导致的资源未打包问题。
3. 确保框架初始化完成：如果读取操作是在runApp执行前触发，需要先调用WidgetsFlutterBinding.ensureInitialized();完成Flutter绑定初始化。
4. 校验文件路径：核对实际文件的目录、文件名、后缀名与代码中填写的路径完全一致，注意大小写敏感。
5. 大文件读取适配：如果XML文件体积超过1MB，推荐使用字节流方式读取，避免卡顿，示例代码如下：

import 'package:flutter/services.dart';

Future<String> convertXMLtoJSON() async {
  try {
    // 读取字节流
    final byteData = await rootBundle.load('assets/xml_file/belovedskincare.xml');
    // 转成字符串
    final xmlContent = utf8.decode(byteData.buffer.asUint8List());
    // 后续执行XML转JSON逻辑
    return xmlContent;
  } catch (e) {
    print('资源读取失败: $e');
    rethrow;
  }
}

内容的提问来源于stack exchange，提问作者Senthur Kumaran