Flutter image_picker Android33+权限异常：图库未唤起、请求返回异常

问题本质 #

• Android 33（API 33）及以上版本，系统用精细媒体权限（READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO）替代了原READ_EXTERNAL_STORAGE权限，若未申请对应精细权限就调用图库，会出现无法打开且无权限请求弹窗的情况。
• Android 13设备上，仍调用旧的Permission.storage.request()请求存储权限时，系统会直接返回permanentlyDenied——因为该权限在API33+已被废弃，必须切换为申请精细媒体权限。

实现步骤 #

1. 清单文件声明权限 #

在AndroidManifest.xml中添加对应权限，同时兼容低版本：

<!-- API33+ 精细媒体权限，按需添加 -->
<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" />

<!-- 兼容API32及以下的存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

2. 动态权限申请逻辑 #

根据系统版本判断要申请的权限组：

val permissionsToRequest = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    // API33+ 申请精细媒体权限
    arrayOf(Manifest.permission.READ_MEDIA_IMAGES)
    // 按需追加视频/音频权限：Manifest.permission.READ_MEDIA_VIDEO
} else {
    // 低版本申请传统存储权限
    arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE)
}

// 发起权限请求
registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { results ->
    results.forEach { (permission, isGranted) ->
        when {
            isGranted -> openGallery() // 权限通过，执行打开图库逻辑
            shouldShowRequestPermissionRationale(permission) -> showPermissionTipDialog() // 用户拒绝但未勾选"不再询问"，显示权限说明
            else -> navigateToAppSettings() // 用户永久拒绝，引导到应用设置页手动开启
        }
    }
}.launch(permissionsToRequest)

3. 打开图库的适配 #

使用API兼容的方式调用图库，比如ActivityResultContracts.GetContent()：

val pickMedia = registerForActivityResult(ActivityResultContracts.GetContent()) { uri ->
    uri?.let { handleSelectedMedia(it) } // 处理选中的媒体文件
}

// 打开图库选择图片，如需视频改为"video/*"
pickMedia.launch("image/*")

关键注意事项 #

• 彻底放弃旧的Permission.storage相关API，API33+下该接口无法正确请求权限，必然返回permanentlyDenied。
• 按需申请权限：只请求业务必需的媒体类型权限，避免过度申请引发用户反感。
• 权限被永久拒绝后，无法再通过代码触发权限弹窗，必须引导用户到应用设置页手动开启。

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