Flutter创建文件失败求助：重装应用后无法生成备份JSON文件

问题根源 #

卸载重装App后原文件创建逻辑失效，主要有这几个核心原因：

1. 硬编码路径适配问题：直接写死/storage/emulated/0/Android/data/com.example.noteapp/backup_note.json，虽属于应用专属目录，但部分Android定制ROM或高版本系统下，卸载重装后目录权限或路径可能出现异常。
2. 异步操作未正确处理：file.create()是异步方法，代码里未加await，导致后续写入操作可能在文件未创建完成时执行，触发文件打开错误。
3. 权限未重新确认：卸载App后之前授予的权限会被清空，低版本Android仍需重新申请存储权限才能操作外部存储。

修复步骤 #

1. 用官方API获取正确存储路径

放弃硬编码，使用path_provider包获取应用专属外部存储目录，适配所有Android版本：

• 先在pubspec.yaml添加依赖：

  dependencies:
    path_provider: ^2.1.1 # 可替换为最新版本
  

• 封装路径获取方法：

  import 'package:path_provider/path_provider.dart';
  
  Future<String> getBackupFilePath() async {
    Directory? appExternalDir = await getExternalStorageDirectory();
    if (appExternalDir == null) {
      throw Exception("无法获取应用存储目录");
    }
    return '${appExternalDir.path}/backup_note.json';
  }
  

2. 修复异步文件创建逻辑

给file.create()加上await，并启用recursive: true自动创建父目录（避免因目录不存在报错）：

Future<void> writeNotesToFile() async {
  try {
    String path = await getBackupFilePath();
    File file = File(path);
    
    print(path);
    bool doesFileExists = await file.exists();
    print(doesFileExists.toString());

    if (!doesFileExists) {
      await file.create(recursive: true); // 必须加await，确保文件创建完成
    }

    // 在这里添加写入笔记的逻辑，例如：
    // await file.writeAsString(jsonEncode(yourNotesData));
  } catch (e) {
    print("文件操作错误：$e");
    // 可添加错误提示逻辑
  }
}

3. 处理低版本Android存储权限

若需兼容Android 9及以下版本，需在android/app/src/main/AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

同时在运行时申请权限，可使用permission_handler包：

• 添加依赖：

  dependencies:
    permission_handler: ^10.2.0 # 可替换为最新版本
  

• 权限检查逻辑：

  import 'package:permission_handler/permission_handler.dart';
  
  Future<bool> checkStoragePermission() async {
    PermissionStatus status = await Permission.storage.request();
    return status.isGranted;
  }
  

• 调用文件写入前校验权限：

  if (await checkStoragePermission()) {
    await writeNotesToFile();
  } else {
    // 提示用户开启存储权限，例如弹Dialog引导到设置页
  }
  

关键说明 #

Android 10及以上版本中，应用专属目录（Android/data/包名/）无需申请存储权限，但卸载重装后该目录会被清空，重新创建文件是正常流程，核心问题还是异步操作和路径获取的规范性。

内容的提问来源于stack exchange，提问作者Irfan Ganatra