Android 13下Flutter调用OpenFile.open遇权限拒绝问题求助

问题根源 #

你遇到的*Permission denied: android.permission.READ_EXTERNAL_STORAGE*错误，本质是Android 10+的存储权限机制变更导致：

• Android 13+将原有的存储权限拆分为媒体类型细分权限，非媒体文件（如PDF）的访问依赖特殊权限MANAGE_EXTERNAL_STORAGE
• MANAGE_EXTERNAL_STORAGE属于系统特殊权限，无法通过常规弹窗请求，必须引导用户手动开启

分步解决方案 #

1. 修正权限请求逻辑 #

替换你的权限请求代码，重点处理特殊权限的引导：

import 'package:permission_handler/permission_handler.dart';

Future askRequiredPermission() async {
  // 请求基础存储权限（适配Android 10及以下）
  final statuses = await [Permission.storage].request();
  
  // 检查特殊存储权限状态
  if (!await Permission.manageExternalStorage.isGranted) {
    // 跳转至应用设置页面让用户手动开启权限
    await openAppSettings();
  }
}

2. 优化AndroidManifest.xml权限配置 #

根据Android版本适配权限，避免冗余配置：

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

<!-- Android 11+的特殊存储权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

<!-- Android 13+可选：媒体文件访问权限（若需处理图片/视频等） -->
<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" />

3. 权限校验前置 #

在打开文件前再次确认权限状态，避免直接调用失败：

ElevatedButton(
  onPressed: () async {
    await askRequiredPermission();
    
    // 双重校验权限
    final hasStoragePerm = await Permission.storage.isGranted;
    final hasManagePerm = await Permission.manageExternalStorage.isGranted;
    
    if (hasStoragePerm || hasManagePerm) {
      final result = await OpenFile.open('/storage/emulated/0/Download/myqr.pdf');
      log(result.message.toString());
    } else {
      log("权限未授予，无法访问文件");
    }
  },
  child: const Text("Open File"),
)

4. 替代方案：使用存储访问框架(SAF) #

如果你的应用并非文件管理器类应用，建议使用SAF替代特殊权限申请，更符合Google权限规范：

import 'package:file_picker/file_picker.dart';

ElevatedButton(
  onPressed: () async {
    // 让用户选择PDF文件
    final pickResult = await FilePicker.platform.pickFiles(
      type: FileType.custom,
      allowedExtensions: ['pdf'],
    );
    
    if (pickResult != null) {
      await OpenFile.open(pickResult.files.single.path);
    }
  },
  child: const Text("选择并打开PDF"),
)

这种方式无需申请MANAGE_EXTERNAL_STORAGE权限，直接通过系统文件选择器获取文件路径，兼容性更好。

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