Flutter iOS端申请contacts权限无弹窗且返回永久拒绝问题

• 确认权限历史状态
  iOS系统机制限制：如果应用之前申请过通讯录权限且用户点击了拒绝，后续再调用permission.request()方法不会弹出申请弹窗，会直接返回PermissionStatus.permanentlyDenied，该限制无法通过代码绕过，只能引导用户跳转系统设置页手动开启权限。
• 检查permission_handler包的iOS编译配置
  大部分开发者遇到该问题都是漏了Podfile中的权限编译配置，需要打开项目下的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_CONTACTS=1',
        # 其他需要的权限也可以在这里对应开启，比如相机是PERMISSION_CAMERA=1
      ]
    end
  end
end

配置修改完成后，执行pod install重新安装iOS依赖。

• 清理缓存重新安装应用
  卸载设备/模拟器上已安装的旧应用，清理Flutter编译缓存后重新运行项目，避免之前的权限缓存和旧编译产物影响测试结果。
• 代码逻辑优化
  建议在申请权限前先查询当前权限状态，针对不同状态做对应处理，参考代码如下：

Future<void> requestContactPermission() async {
  PermissionStatus currentStatus = await Permission.contacts.status;
  // 已授权，直接读取通讯录
  if (currentStatus.isGranted) {
    refreshContacts();
    return;
  }
  // 未申请过权限，发起申请
  if (currentStatus.isDenied) {
    PermissionStatus requestResult = await Permission.contacts.request();
    if (requestResult.isGranted) {
      refreshContacts();
    }
    return;
  }
  // 永久拒绝，引导用户跳转设置
  if (currentStatus.isPermanentlyDenied) {
    // 可以在这里弹出提示框告知用户需要开启权限，然后调用openAppSettings()跳转设置页
    openAppSettings();
  }
}

• 测试环境校验
  部分版本的iOS模拟器存在权限申请逻辑异常的问题，建议优先使用真机测试验证。

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