PlatformException:PERMISSION_DENIED,由于权限范围不足,操作被拒绝
PlatformException: PERMISSION_DENIED, The operation was denied because the permission scope is insufficient
ID: flutter/insufficient-permission-scope
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| Flutter 3.19 | active | — | — | — |
| Dart 3.3 | active | — | — | — |
| Android 14 | active | — | — | — |
| iOS 17.2 | active | — | — | — |
根因分析
请求了平台特定权限(如摄像头、位置、存储),但用户仅授予了有限范围,或者未在应用清单中声明该权限。
English
A platform-specific permission (e.g., camera, location, storage) was requested but the user granted only a limited scope, or the permission was not declared in the app manifest.
官方文档
https://docs.flutter.dev/development/data-and-backend/reading-writing-images解决方案
-
Use the permission_handler package to explicitly request the permission and check the status before performing the operation. Example: `final status = await Permission.camera.request(); if (status.isGranted) { // proceed } else { // show rationale }` -
Declare the exact permission in AndroidManifest.xml (e.g., <uses-permission android:name="android.permission.CAMERA" />) and in Info.plist (e.g., NSCameraUsageDescription).
-
For Android 14+ granular media permissions, request each sub-permission (e.g., ACCESS_MEDIA_LOCATION) separately using the `photo_manager` or similar package that handles scoped storage.
无效尝试
常见但无效的做法:
-
50% 失败
Over-declaring permissions may cause app store rejection or user distrust; also, runtime permission requests still require user consent and proper handling.
-
75% 失败
Ignoring the result means the app proceeds without the required permission, leading to the same exception when the operation is attempted.
-
85% 失败
Lowering compileSdkVersion may introduce security vulnerabilities and prevent use of newer APIs; it also does not resolve runtime permission denials on newer devices.