Flutter Image Compress无法访问Android文件夹，压缩结果返回null求助

原因 #

• Android 10（API 29）及以上启用的**分区存储（Scoped Storage）**机制，将「内部存储/Android」划为应用私有目录区域，第三方应用默认无直接读写权限——哪怕申请了READ_EXTERNAL_STORAGE也无法直接访问该目录下的文件，这是系统层面的权限隔离规则。
• 你的代码直接使用原文件路径作为输入和输出路径，在私有目录下没有写入权限，导致压缩操作失败，最终返回null。

解决办法 #

方法1：通过文件字节流处理（核心方案） #

绕开直接访问私有目录路径的限制，先读取文件字节，压缩后写入应用可访问的目录（比如自身缓存目录、公共媒体目录）：

import 'dart:io';
import 'dart:typed_data';
import 'package:flutter_image_compress/flutter_image_compress.dart';
import 'package:path_provider/path_provider.dart';

Future<File?> compressPrivateDirImage(File imageFile) async {
  try {
    // 读取原文件字节
    Uint8List rawBytes = await imageFile.readAsBytes();
    
    // 压缩字节数据
    Uint8List? compressedBytes = await FlutterImageCompress.compressWithList(
      rawBytes,
      quality: 50,
    );
    
    if (compressedBytes == null) return null;
    
    // 获取应用可写的缓存目录
    Directory tempDir = await getTemporaryDirectory();
    String outputPath = "${tempDir.path}/compressed_${DateTime.now().millisecondsSinceEpoch}.jpg";
    
    // 写入压缩后的文件
    File compressedFile = File(outputPath);
    await compressedFile.writeAsBytes(compressedBytes);
    
    return compressedFile;
  } catch (e) {
    print("压缩失败: $e");
    return null;
  }
}

方法2：用系统文件选择器获取合规路径（推荐用户选择场景） #

如果是用户手动选择图片，使用image_picker或file_picker等库时，系统会返回带权限的内容URI，而非原始绝对路径，直接用这个路径配合压缩方法，同时将输出路径指定到可写目录：

import 'package:image_picker/image_picker.dart';
import 'package:flutter_image_compress/flutter_image_compress.dart';
import 'package:path_provider/path_provider.dart';

Future<void> pickAndCompressImage() async {
  final XFile? pickedFile = await ImagePicker().pickImage(source: ImageSource.gallery);
  if (pickedFile != null) {
    Directory tempDir = await getTemporaryDirectory();
    String outputPath = "${tempDir.path}/compressed_out.jpg";
    
    var result = await FlutterImageCompress.compressAndGetFile(
      pickedFile.path,
      outputPath,
      quality: 50,
    );
    print(result);
  }
}

方法3：兼容Android 9及以下（仅旧版本） #

如果需要适配Android 9（API 28）及更低版本，可以申请WRITE_EXTERNAL_STORAGE权限，但Android 10+依然无效，仅作为补充兼容方案：

1. 在AndroidManifest.xml中添加权限：

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

2. 运行时动态请求权限后，再执行原压缩逻辑。

关键注意事项 #

• 禁止直接写入「内部存储/Android」目录，这违反Android存储规范，不仅会触发权限错误，还可能导致Google Play审核不通过。
• 压缩后的文件优先存储在应用私有目录（缓存、文件目录），如需共享到系统相册，可通过媒体扫描接口将文件加入媒体库。

内容的提问来源于stack exchange，提问作者Mark Nugromentry