Flutter FilePicker插件FileType.custom/any返回null问题求助

针对你使用file_picker 6.1.1在三星M14 5G上选择PDF、DOCX等非媒体文件返回null的问题，以下是具体解决方案：

1. 适配Android 13+权限机制 #

三星M14 5G搭载Android 13系统，该版本对非媒体文件的权限规则有变更：原有的READ_EXTERNAL_STORAGE仅在Android 12及以下生效，Android 13+需要添加MANAGE_EXTERNAL_STORAGE权限来访问全量文件。

步骤： #

（1）更新AndroidManifest.xml权限声明

<!-- 针对Android 12及以下的读写权限 -->
<uses-permission
    android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32"/>
<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="32"/>

<!-- 针对Android 13+的全存储权限 -->
<uses-permission 
    android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="33" />

（2）运行时请求权限

使用permission_handler插件请求权限（需先在pubspec.yaml中添加依赖）：

import 'package:permission_handler/permission_handler.dart';
import 'dart:io';

Future<bool> checkStoragePermission() async {
  if (Platform.isAndroid) {
    if (await Permission.manageExternalStorage.request().isGranted) {
      return true;
    } else {
      // 权限被拒绝时引导用户去设置页开启
      await openAppSettings();
      return false;
    }
  }
  return true;
}

在文件选择前先检查权限：

Future<void> handleFilePicker(BuildContext context) async {
  try {
    // 先检查权限
    if (!await checkStoragePermission()) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('请开启存储权限后重试')),
      );
      return;
    }

    setState(() {
      isPickingFile = true;
    });

    // 后续的file_picker调用...
  } catch (e, stackTrace) {
    // 异常处理逻辑...
  }
}

2. 调整file_picker调用参数 #

• 禁用withData: true：该参数会将文件内容加载到内存，部分非媒体文件可能因兼容性问题导致返回null，改为使用文件流或路径：

FilePickerResult? result = await FilePicker.platform.pickFiles(
  withData: false,
  withReadStream: true, // 推荐用流读取文件，避免内存溢出
  type: FileType.custom,
  allowedExtensions: ['pdf', 'docx', 'doc', 'txt'],
  allowMultiple: false,
);

• 避免直接依赖path字段：Android 13+通过SAF返回的文件可能没有本地路径，改用readStream或bytes处理文件：

if (result != null) {
  final selectedFile = result.files.single;
  // 使用文件流上传
  final fileStream = selectedFile.readStream;
  // 上传逻辑...
}

3. 修复插件集成问题 #

如果以上方法无效，尝试重置插件环境：

• 执行flutter clean清除缓存
• 删除android/build文件夹
• 重新执行flutter pub get
• 卸载应用后重新安装

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