Flutter/Dart File.writeAsBytes执行无报错但找不到保存的PDF文件

你的代码没有出现写入失败的问题，文件实际上已经成功保存到你打印的路径下，找不到文件是两个核心问题导致的：

• 你选择的存储路径属于应用专属外部存储目录：路径格式为/storage/emulated/0/Android/data/你的应用包名/，从Android 11（API 30）开始，系统对这个目录做了强制沙箱隔离：只有应用自身、USB调试模式下的电脑端可以访问该目录内容，系统自带文件管理器、第三方应用默认没有权限读取这个路径，所以你在设备上翻找文件时根本看不到对应目录和文件。另外读写这个目录从Android 4.4开始就不需要申请任何存储权限，你之前写的权限申请逻辑、Manifest里加的一堆权限，对访问这个目录完全没有作用。
• 你配置的权限存在大量冗余无效项：READ_INTERNAL_STORAGE是Android系统内部保留的非公开权限，第三方应用声明了也无法获得；MANAGE_EXTERNAL_STORAGE是所有文件访问特权权限，仅面向文件管理器、数据备份类核心功能需要全量存储访问的应用开放，普通应用申请这个权限上架应用市场会被直接拒审，完全没必要加。

根据你保存PDF后需要让用户在系统中可找到的需求，直接将文件存储到系统公共Download目录即可，不要使用应用专属目录。

具体调整步骤 #

1. 清理AndroidManifest.xml中的存储权限配置，仅保留必要项：

<!-- 兼容Android 12及以下版本读取公共存储目录 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- 兼容Android 9及以下版本写入公共存储目录 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

注意：不要在<application>标签上长期依赖android:requestLegacyExternalStorage="true"配置，这个配置仅在Android 10上临时生效，Android 11及以上版本会直接忽略该配置，无法绕过分区存储限制。

2. 替换原有取路径的逻辑，不要使用getExternalStorageDirectories()获取专属目录，分Android版本写入公共Download目录：
   • Android 10（API 29）及以上：不需要申请存储权限，通过系统MediaStore接口将PDF写入公共Download目录，写入后系统会自动扫描文件，立刻可以在系统文件管理器的下载分类中找到。可以通过MethodChannel原生调用MediaStore API实现，也可以使用成熟的存储插件封装好的公共目录写入能力，不要直接硬编码公共路径写入，会被分区存储机制拦截。
   • Android 9（API 28）及以下：申请存储权限后，直接将文件写入公共下载路径/storage/emulated/0/Download，写完后发送ACTION_MEDIA_SCANNER_SCAN_FILE系统广播通知媒体库扫描新文件，避免文件管理器延迟识别。

核心代码示例：

import 'dart:io';
import 'dart:typed_data';
import 'package:base64/base64.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:device_info_plus/device_info_plus.dart';
import 'package:path/path.dart' as path;

Future<File?> savePdfToDownload(String encodedBase64) async {
  final Uint8List pdfBytes = base64.decode(encodedBase64);
  final String fileName = '${DateTime.now().millisecondsSinceEpoch}.pdf';

  if (Platform.isAndroid) {
    final AndroidDeviceInfo androidInfo = await DeviceInfoPlugin().androidInfo;
    final int sdkInt = androidInfo.version.sdkInt;

    // Android 10+走MediaStore写入逻辑
    if (sdkInt >= 29) {
      // 此处替换为你实现的MediaStore写入逻辑，将pdfBytes写入公共Download目录
      // 写入成功后返回对应File对象即可
    } else {
      // 低版本先申请存储权限
      final PermissionStatus status = await Permission.storage.request();
      if (!status.isGranted) return null;

      // 公共Download目录路径
      final String downloadDir = '/storage/emulated/0/Download';
      final File targetFile = File(path.join(downloadDir, fileName));
      await targetFile.writeAsBytes(pdfBytes);

      // 发送广播通知系统扫描新文件
      // 此处可通过MethodChannel调用原生发送媒体扫描广播
      return targetFile;
    }
  }
  // iOS逻辑可按需自行适配
  return null;
}

备选方案（不推荐） #

如果你一定要把文件存在应用专属目录，需要注意：

• 不要指望用户能从系统文件管理器找到这些文件，必须在你的应用内提供文件查看、分享、导出入口，让用户可以在应用内打开PDF，或者手动把文件导出到公共目录。
• 应用卸载时，专属目录下的所有文件会被系统自动清除，不要在这个目录存用户需要长期保留的重要文件。

• 注意区分两类存储路径：getExternalStorageDirectories()返回的是应用专属外部存储目录，归应用私有，卸载即删除，用户不可见；系统公共目录（Download、Documents、Pictures等）下的文件所有应用可访问，卸载应用后文件仍会保留。
• 存储权限不是万能的：Android 10之后的分区存储机制下，哪怕获取了存储权限，也不能通过硬编码路径随意读写其他应用的专属目录，必须走系统提供的MediaStore/存储访问框架（SAF）接口操作文件。
• 写完公共目录的文件如果暂时找不到，可以先重启系统文件管理器，或者触发一次媒体库扫描，不要直接判定为写入失败。

内容的提问来源于stack exchange，提问作者Caio Sant'Anna