iOS端图片选择器首次调用失败问题排查与修复方案

1. 提前申请相册权限，避免弹窗与选择器启动冲突 #

在首次调用图片选择器前，主动申请相册权限，等权限状态明确后再启动选择器，避免权限弹窗打断选择器的初始化流程：

import 'package:permission_handler/permission_handler.dart';

// 检查并申请相册权限
Future<bool> _requestGalleryPermission() async {
  final status = await Permission.photos.request();
  return status.isGranted;
}

// 调用图片选择器的核心方法
Future<void> _pickImage() async {
  final hasPermission = await _requestGalleryPermission();
  if (!hasPermission) {
    // 处理权限拒绝逻辑，比如提示用户去设置开启权限
    return;
  }
  try {
    // 注意：新版本image_picker已废弃PickedFile，改用XFile
    final XFile? file = await _picker.pickImage(source: ImageSource.gallery);
    // 处理选中的图片
  } catch (e) {
    // 捕获并处理异常
    print(e);
  }
}

2. 升级image_picker到最新稳定版本 #

旧版本的image_picker在iOS权限弹窗后存在根控制器获取异常的bug，升级到最新版本可修复这类底层问题：
执行命令更新依赖：

flutter pub upgrade image_picker

同时将代码中的PickedFile替换为XFile（新版本已废弃PickedFile）。

3. 增加调用锁，防止重复触发异常 #

添加布尔变量标记选择器的活跃状态，避免二次点击触发already_active异常：

bool _isPickerActive = false;

Future<void> _pickImage() async {
  if (_isPickerActive) return;
  _isPickerActive = true;
  
  try {
    final hasPermission = await _requestGalleryPermission();
    if (!hasPermission) return;
    final XFile? file = await _picker.pickImage(source: ImageSource.gallery);
    // 处理图片逻辑
  } catch (e) {
    print(e);
  } finally {
    _isPickerActive = false;
  }
}

4. iOS原生端配置优化（解决正式版崩溃） #

在iOS项目的Info.plist中确保已正确添加相册权限描述：

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问您的相册以选择图片</string>

同时检查AppDelegate.swift，确保根控制器配置正常，避免出现Failed to determine root view controller错误：

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

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