Flutter iOS端相机跳转返回后无法重新初始化显示黑屏

问题背景 #

Flutter项目中实现两个页面跳转使用相机功能，从第二页返回第一页时，iOS端相机出现黑屏现象，安卓端无此问题。尝试过注释中的多种常规修复方法（如重新初始化相机、dispose后重建等）均无效，仅通过直接传递CameraController参数可解决，但项目架构不允许采用该方案。

可行解决方案 #

1. 利用页面生命周期重新初始化相机 #

在第一页的didPopNext生命周期方法（从第二页返回时触发）中，先确保旧的相机控制器已正确释放，再重新初始化相机：

@override
void didPopNext() {
  super.didPopNext();
  // 先释放旧控制器资源
  _cameraController?.dispose();
  // 重新初始化相机
  _initCamera();
}

Future<void> _initCamera() async {
  final cameras = await availableCameras();
  _cameraController = CameraController(
    cameras[0],
    ResolutionPreset.medium,
    enableAudio: false,
  );
  await _cameraController!.initialize();
  // 确保页面未被销毁时更新状态
  if (mounted) {
    setState(() {});
  }
}

注意：初始化完成后必须判断页面是否处于mounted状态，避免调用setState时出现异常。

2. 通过全局状态管理维护相机状态 #

使用Provider、GetX等状态管理工具，在全局层面管理相机的初始化逻辑，而非直接传递CameraController实例。当返回第一页时，触发全局状态的相机重新初始化：

// GetX全局状态控制器示例
class CameraStateManager extends GetxController {
  CameraController? _cameraController;
  final RxBool _isCameraReady = false.obs;

  bool get isCameraReady => _isCameraReady.value;

  Future<void> initCamera() async {
    // 先释放已有控制器
    if (_cameraController != null) {
      await _cameraController!.dispose();
    }
    final cameras = await availableCameras();
    _cameraController = CameraController(
      cameras[0],
      ResolutionPreset.medium,
    );
    await _cameraController!.initialize();
    _isCameraReady.value = true;
  }

  @override
  void onClose() {
    _cameraController?.dispose();
    super.onClose();
  }
}

// 第一页中调用
@override
void didPopNext() {
  super.didPopNext();
  Get.find<CameraStateManager>().initCamera();
}

这种方式既规避了直接传递控制器的限制，又能统一管理相机资源的生命周期。

3. iOS专属延迟初始化处理 #

iOS的相机会话在页面切换时可能因资源未及时释放导致黑屏，可尝试添加短暂延迟后再初始化相机：

@override
void didPopNext() {
  super.didPopNext();
  // 延迟100ms，给iOS相机资源释放留出缓冲时间
  Future.delayed(const Duration(milliseconds: 100), () {
    _initCamera();
  });
}

关键验证点 #

• 每次初始化相机前必须调用dispose()，避免相机资源泄漏
• 检查iOS项目的Info.plist是否正确配置了NSCameraUsageDescription权限描述，权限异常也可能引发黑屏
• 确保页面跳转时，相机初始化流程已完成，避免中途切换页面导致资源异常

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