Flutter iOS端权限申请无弹窗且设置页无权限项问题求助

问题情况 #

已在iOS/Runner/Info.plist添加如下权限描述：

<key>NSCameraUsageDescription</key>
<string>We need access to your camera to take photos.</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>We need to access your current location for manage the dispatching routing.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>We need to access your current location for manage the dispatching routing.</string>
<key>NSMicrophoneUsageDescription</key>
<string>We need access your microphone to talk to driver.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>For uploading driver's report including dispatch and clock in/out</string>

代码中调用权限请求逻辑：

Map<Permission, PermissionStatus> statuses = await [
  Permission.camera,
  Permission.locationWhenInUse,
  Permission.locationAlways,
  Permission.microphone,
].request();

但iOS设备无权限申请弹窗，进入设置后无任何权限选项，功能因权限缺失无法使用。

排查与解决步骤 #

• 确认权限插件配置完整性
  使用permission_handler插件时，需确保Podfile配置正确。在iOS/Podfile中添加以下内容（针对iOS 10+）：

  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)',
        ]
      end
    end
  end
  

  同时确保插件版本与Flutter 3.10.6兼容（推荐使用permission_handler 10.x或11.x版本）。

• 清理构建缓存并重新编译
  执行以下步骤彻底清理缓存：

  1. 终端运行flutter clean
  2. 进入iOS目录，执行pod deintegrate
  3. 执行pod install
  4. 重新用Xcode或Flutter命令运行项目

• 调整权限请求时机
  避免在runApp()之前发起权限请求，应在Widget初始化完成后（如initState()方法内）调用请求逻辑，确保App已完成基础初始化：

  @override
  void initState() {
    super.initState();
    _requestPermissions();
  }
  
  Future<void> _requestPermissions() async {
    Map<Permission, PermissionStatus> statuses = await [
      Permission.camera,
      Permission.locationWhenInUse,
      Permission.locationAlways,
      Permission.microphone,
    ].request();
    // 处理权限状态
  }
  

• 检查Info.plist的正确性

  1. 确认修改的是iOS/Runner/Info.plist文件，而非其他副本
  2. 检查权限Key的拼写是否完全正确（例如NSLocationAlwaysAndWhenInUseUsageDescription无拼写错误）
  3. 确保XML格式合法，无标签未闭合等语法问题

• 修正位置权限请求逻辑
  iOS对位置权限的请求有顺序要求：需先请求locationWhenInUse，获得授权后再请求locationAlways，不能同时批量请求。调整代码如下：

  Future<void> _requestPermissions() async {
    // 先请求WhenInUse权限
    final whenInUseStatus = await Permission.locationWhenInUse.request();
    if (whenInUseStatus.isGranted) {
      // 再请求Always权限
      await Permission.locationAlways.request();
    }
    // 其他权限请求
    await Permission.camera.request();
    await Permission.microphone.request();
  }
  

• 检查Xcode项目配置

  1. 打开Xcode项目，进入Runner目标的Signing & Capabilities页面
  2. 若需要后台位置更新，添加Background Modes并勾选Location updates
  3. 确认项目的Info标签页中已同步显示添加的权限描述（避免Info.plist未被正确加载）

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