Flutter 2.5.3下permission_handler^8.2.5相册权限状态返回值异常问题

排查步骤 #

• 首先确认permission_handler依赖版本：Flutter 2.5.3对应需要使用8.0.0+以上版本的permission_handler，低于该版本未适配新的系统权限策略，会出现已授权依然返回isDenied的异常。
• 确认端侧权限配置是否完整：
  • iOS端检查Info.plist是否配置了NSPhotoLibraryUsageDescription权限说明，同时检查Podfile中是否开启了相册权限的编译开关。
  • Android端检查AndroidManifest.xml是否配置了对应相册读写权限，Android13及以上版本需要额外配置READ_MEDIA_IMAGES权限。
• 确认测试系统版本：iOS14、Android13之后系统相册权限逻辑有大幅调整，低版本的permission_handler未做适配会出现状态读取错误。
• 检查权限逻辑是否正确：当前代码仅读取了权限缓存状态，若用户从未触发过授权弹窗，直接读取的默认状态就是isDenied。

解决方法 #

1. 升级permission_handler到适配Flutter 2.5.x的稳定版本，在pubspec.yaml中修改依赖：

   dependencies:
     permission_handler: ^8.3.0
   

2. 补充iOS端Podfile配置，在post_install块中添加相册权限的编译开关：

   post_install do |installer|
     installer.pods_project.targets.each do |target|
       flutter_additional_ios_build_settings(target)
       target.build_configurations.each do |config|
         config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
           '$(inherited)',
           # 启用相册权限
           'PERMISSION_PHOTOS=1',
         ]
       end
     end
   end
   

   配置完成后执行flutter clean && flutter pub get && cd ios && pod install重新编译项目。
3. 修正权限请求逻辑，先主动触发授权再读取状态，同时适配iOS14+的有限访问权限：

   // 先调用request触发授权弹窗，不要直接读取status
   PermissionStatus status = await Permission.photos.request();
   print('## deny: ${status.isDenied}');
   print('## grant: ${status.isGranted}');
   print('## limit: ${status.isLimited}');
   print('## permanently deny: ${status.isPermanentlyDenied}');
   print('## restrict: ${status.isRestricted}');
   // 有限访问也视为授权可用，不要仅判断isGranted
   if (!status.isGranted && !status.isLimited) {
     await showDialog(...)
   }
   

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