Flutter image_picker遇already_active错误及选择无响应问题求助

问题描述 #

• 相机拍摄照片确认后无任何回调，无法加载显示图片
• 选择图片返回应用后无响应，再次打开选择器抛出异常：Unhandled Exception: PlatformException(already_active, Image picker is already active, null, null)

已排查操作 #

• 已配置AndroidManifest.xml和Info.plist的权限
• 使用最新版本image_picker: ^1.1.2
• 采用await调用pickImage方法
• 已处理pickImage返回null的场景
• 确认未重复触发选择器

可行解决思路 #

1. 补全原生端配置细节 #

Android 端

• 确认AndroidManifest.xml中添加了UCrop的Activity配置（部分版本的image_picker依赖该组件，缺失会导致回调中断）：

<activity
    android:name="com.yalantis.ucrop.UCropActivity"
    android:screenOrientation="portrait"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar"/>

• 若targetSdkVersion ≥33，需申请READ_MEDIA_IMAGES权限，替代旧版的READ_EXTERNAL_STORAGE

iOS 端

• 确保Info.plist中权限描述完整（必须添加描述文本，否则权限申请不生效）：

<key>NSCameraUsageDescription</key>
<string>需要使用相机拍摄照片</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册选择图片</string>

• 检查项目Deployment Target是否≥11.0（image_picker的最低要求）

2. 锁定选择器状态，避免重复调用 #

给pickImage方法添加状态锁，确保回调完成后释放锁，从根源避免already_active异常：

bool _isPickerBusy = false;

Future<void> _selectImage(ImageSource source) async {
  if (_isPickerBusy) return;
  _isPickerBusy = true;
  
  try {
    final XFile? pickedFile = await ImagePicker().pickImage(source: source);
    if (pickedFile != null) {
      // 处理选中的图片，比如更新状态显示图片
      setState(() {
        _selectedImage = File(pickedFile.path);
      });
    }
  } catch (e) {
    print('图片选择失败: $e');
  } finally {
    _isPickerBusy = false;
  }
}

另外，可通过CancelToken在组件销毁时取消未完成的选择任务：

late final ImagePicker _imagePicker;
CancelToken? _pickerCancelToken;

@override
void initState() {
  super.initState();
  _imagePicker = ImagePicker();
}

@override
void dispose() {
  _pickerCancelToken?.cancel();
  super.dispose();
}

Future<void> _selectImage(ImageSource source) async {
  _pickerCancelToken = CancelToken();
  try {
    final XFile? pickedFile = await _imagePicker.pickImage(
      source: source,
      cancelToken: _pickerCancelToken,
    );
    // 处理图片逻辑
  } catch (e) {
    if (e is OperationCanceledError) {
      print('选择已取消');
    } else {
      print('错误信息: $e');
    }
  }
}

3. 清理缓存并重建项目 #

• 执行flutter clean清理Flutter缓存，再运行flutter pub get重新拉取依赖
• Android端：进入android目录执行./gradlew clean；iOS端：进入ios目录执行pod deintegrate && pod install
• 重启模拟器/真机，重新运行项目

4. 检查页面生命周期与上下文问题 #

• 若在Dialog/BottomSheet中调用选择器，确保使用的context未被销毁，可尝试使用GlobalKey获取组件上下文
• 避免在StatelessWidget中直接处理异步回调，改用StatefulWidget管理状态，确保回调能正确更新UI

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