Flutter应用文件上传权限异常：未触发外部存储权限申请

问题核心原因 #

1. 权限声明未配置：AndroidManifest.xml中缺少对应版本的媒体/存储权限，系统无法触发权限申请弹窗。
2. Android版本权限拆分：Android 13+将原有的READ_EXTERNAL_STORAGE拆分为READ_MEDIA_IMAGES、READ_MEDIA_AUDIO、READ_MEDIA_VIDEO，FilePicker默认不会自动请求这些新权限。
3. 权限已被拒绝过：用户之前手动拒绝权限并勾选“不再询问”，后续请求直接返回拒绝状态，不会再弹出申请窗口。

解决方案 #

1. 完善AndroidManifest.xml权限声明 #

在android/app/src/main/AndroidManifest.xml中添加对应权限：

• Android 12及以下：

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

• Android 13+（按需添加）：

<!-- 图片/视频权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- 音频权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<!-- 单独视频权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

2. 手动请求权限后再调用FilePicker #

使用permission_handler包主动请求权限，确保用户授权后再打开文件选择器：

步骤1：添加依赖

在pubspec.yaml中添加：

dependencies:
  permission_handler: ^10.2.0 # 可替换为最新版本
  device_info_plus: ^9.0.2 # 用于判断Android版本

步骤2：修改pickFile方法

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

Future<void> pickFile() async {
  try {
    PermissionStatus status;
    final isAndroid = Theme.of(context).platform == TargetPlatform.android;

    if (isAndroid) {
      final androidInfo = await DeviceInfoPlugin().androidInfo;
      if (androidInfo.version.sdkInt >= 33) {
        // Android 13+ 请求媒体权限（根据你的FileType调整）
        status = await Permission.photos.request();
        // 若选择音频文件，替换为 Permission.audio
      } else {
        // Android 12及以下 请求存储权限
        status = await Permission.storage.request();
      }
    } else {
      // iOS/其他平台 请求相册权限
      status = await Permission.photos.request();
    }

    if (status.isGranted) {
      // 权限通过，打开文件选择器
      final result = await FilePicker.platform.pickFiles(
        type: FileType.media,
        allowMultiple: false,
      );

      if (result != null) {
        final _fileName = result.files.first.name;
        final pickedFile = result.files.first;
        final fileToDisplay = File(pickedFile.path!);
        print("file name: $_fileName");
      } else {
        print('User canceled file picker');
      }
    } else {
      if (status.isPermanentlyDenied) {
        // 权限被永久拒绝，引导用户去设置开启
        showSnackBar(context, "权限被永久拒绝，请前往应用设置开启媒体访问权限");
        await openAppSettings();
      } else {
        showSnackBar(context, "需要媒体访问权限才能选择文件");
      }
    }
  } catch (e) {
    showSnackBar(context, e.toString());
  }
}

3. 处理权限拒绝场景 #

如果用户拒绝权限且勾选“不再询问”，通过openAppSettings()直接跳转到应用设置页面，引导用户手动开启权限。

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