Flutter FilePicker 6.0.0在Android singleInstance模式下返回文件路径为空

问题原因 #

Android的singleInstance启动模式会将应用置于独立的任务栈中，调用文件选择器这类第三方应用后，系统返回时可能创建新的应用实例，而非回到发起调用的原实例，导致pickFiles的结果无法正确传递。此外，直接读取path字段在跨应用场景下存在可靠性问题。

解决方案 #

1. 调整Activity启动模式（优先推荐）

将主Activity的launchMode从singleInstance改为singleTask或standard：

• singleTask模式同样保证应用单实例，但允许第三方应用在当前任务栈中启动，确保文件选择器的结果能正确回传给原实例。
• 修改AndroidManifest.xml：

  <activity
      android:name=".MainActivity"
      android:launchMode="singleTask"
      <!-- 保留其他原有属性 -->
      >
  </activity>
  

2. 改用getAbsolutePath()获取文件路径

FilePicker提供的getAbsolutePath()方法，相比直接读取path字段，能更可靠地处理跨应用返回的文件路径：

FilePickerResult? result = await FilePicker.platform.pickFiles(
  allowedExtensions: ['jpg','jpeg','png','pdf'],
  type: FileType.custom,
);
if (result != null) {
  String? filePath = result.files.single.getAbsolutePath();
  if (filePath != null) {
    File file = File(filePath);
    controller.isPasswordProtected.value =
        await FileHelper.checkFileIsPasswordProtected(file);
    controller.fileSelected(file);
    controller.uploadDocument();
  }
}

3. 验证FilePicker的Android配置正确性

确保AndroidManifest.xml中已添加必要权限和Provider配置：

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

<application ...>
    <provider
        android:name="com.mr.flutter.plugin.filepicker.FilePickerProvider"
        android:authorities="${applicationId}.filepicker.provider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

同时确认res/xml/file_paths.xml存在且配置正确：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external_files" path="." />
</paths>

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