Android 13存储文件访问权限异常问题求助

问题根源 #

Android 13（API 33+）彻底重构了存储权限体系：

• 原有的READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE权限被废弃，拆分为媒体细分权限（READ_MEDIA_IMAGES、READ_MEDIA_VIDEO、READ_MEDIA_AUDIO）
• 若需访问非媒体文件（如文档、压缩包等），仅靠媒体权限无法满足，会触发权限拒绝错误

你的代码中，API33+时仅请求了Permission.photos（对应READ_MEDIA_IMAGES），但如果AppConfig.allowedFileExtensions包含非图片格式，FilePicker访问这些文件时就会因权限不足报错。

针对性修复方案 #

情况1：仅需访问图片/视频/音频等媒体文件 #

1. 更新权限声明
   在AndroidManifest.xml中替换旧权限，添加对应媒体权限：

   <!-- 移除旧的存储权限 -->
   <!-- <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> -->
   <!-- <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> -->
   
   <!-- 添加媒体权限，按需选择 -->
   <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
   <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
   <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
   <uses-permission android:name="android.permission.CAMERA"/>
   <uses-permission android:name="android.permission.INTERNET"/>
   

2. 调整权限请求逻辑
   根据你需要访问的媒体类型，请求对应权限：

   if (androidInfo.version.sdkInt <= 32) {
     statusess = await [Permission.storage].request();
   } else {
     // 按需组合权限，比如同时需要图片和视频
     statusess = await [Permission.photos, Permission.videos].request();
   }
   

情况2：需要访问任意类型文件（含非媒体文件） #

方案A：使用存储访问框架（SAF，推荐）

无需申请特殊权限，直接让FilePicker调用系统SAF选择文件，兼容性更好：

FilePickerResult result;
try {
  result = await FilePicker.platform.pickFiles(
    type: FileType.custom,
    allowedExtensions: AppConfig.allowedFileExtensions,
    withData: true,
    allowMultiple: maxFiles > 1,
    useSAF: true, // 开启SAF模式
  );
} catch (e) {
  debugPrint('Unsupported operation $e');
}

方案B：申请MANAGE_EXTERNAL_STORAGE权限（仅适合文件管理器类应用）

该权限需要Google Play审核，仅当你的应用核心功能是文件管理时使用：

1. 添加权限声明

   <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
   <!-- 保留必要的媒体/相机权限 -->
   <uses-permission android:name="android.permission.CAMERA"/>
   <uses-permission android:name="android.permission.INTERNET"/>
   

2. 调整权限请求逻辑

   if (androidInfo.version.sdkInt <= 32) {
     statusess = await [Permission.storage].request();
   } else {
     statusess = await [Permission.manageExternalStorage].request();
   }
   

额外检查点 #

• 确认AppConfig.allowedFileExtensions的格式是否正确，避免因扩展名匹配问题导致的权限误判
• 测试时需先清除应用原有权限，再重新授权，避免缓存的旧权限状态影响测试结果

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