Flutter开发Android应用无法读取DCIM/Camera目录图片问题求助

核心问题分析 #

你遇到的问题本质是两个点：权限请求未触发（无弹窗）、直接路径访问受Scoped Storage限制，两者叠加导致只能读到部分子目录，无法获取目标图片文件。

具体遗漏点及解决办法 #

1. 未实现动态权限申请逻辑 #

Android 6.0（API 23）及以上版本，危险权限（如存储类权限）仅在AndroidManifest.xml声明是不够的，必须在代码中主动发起权限请求，系统才会弹出权限授权弹窗。

解决步骤：

• 引入权限处理插件（比如permission_handler），在pubspec.yaml添加依赖：

  dependencies:
    permission_handler: ^10.2.0
  

• 编写权限请求代码，根据Android版本适配不同权限：

  import 'package:permission_handler/permission_handler.dart';
  
  Future<bool> requestImagePermission() async {
    Permission targetPermission;
    // 区分API 33+和低版本权限
    if (await Permission.mediaLibrary.isSupported) {
      targetPermission = Permission.mediaLibrary;
    } else {
      targetPermission = Permission.storage;
    }
  
    final PermissionStatus status = await targetPermission.request();
    return status.isGranted;
  }
  

• 在APP启动或加载图片前调用这个方法，确认权限授权后再执行图片读取操作。

2. 忽略了Scoped Storage的路径访问限制 #

Android 10（API 29）及以上启用了Scoped Storage机制，APP默认无法直接通过文件路径访问其他应用（比如系统相机）创建的媒体文件。你直接遍历/storage/emulated/0/DCIM/Camera目录，只能读到APP自身创建的文件或不受限制的子目录，无法获取相机拍摄的图片。

解决办法：改用MediaStore查询媒体库中的图片，而非直接遍历路径。可以用media_store_plus这类插件简化操作，示例代码：

import 'package:media_store_plus/media_store_plus.dart';

Future<List<String>> fetchCameraImages() async {
  final List<String> imagePaths = [];
  // 查询DCIM/Camera下的所有图片
  final queryResult = await MediaStore.query(
    uri: MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection: [MediaStore.Images.Media.DATA],
    selection: "${MediaStore.Images.Media.DATA} LIKE ?",
    selectionArgs: ["%DCIM/Camera/%"],
  );

  if (queryResult != null && queryResult.isNotEmpty) {
    for (final item in queryResult) {
      final path = item[MediaStore.Images.Media.DATA];
      if (path != null) imagePaths.add(path);
    }
  }
  return imagePaths;
}

3. 权限声明的适配问题 #

检查AndroidManifest.xml中的权限声明是否正确，注意API版本的适配：

<!-- 适配API 32及以下版本 -->
<uses-permission 
    android:name="android.permission.READ_EXTERNAL_STORAGE" 
    android:maxSdkVersion="32"/>
<!-- 适配API 33+版本 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

确保权限声明放在<manifest>标签下、<application>标签之外，避免位置错误导致权限不生效。

额外注意点 #

如果之前手动拒绝过权限，系统可能不再弹出请求弹窗，此时需要：

• 卸载APP后重装，重置权限状态
• 手动进入系统设置，找到你的APP开启存储/媒体访问权限

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