Flutter调用相机出现NoSuchMethodError:方法'[]'被调用在null上如何解决

报错根因 #

你遇到的NoSuchMethodError: The method '[]' was called on null. receiver: null tried calling [] (0)错误，本质是代码中对一个值为null的列表对象调用了[0]取第一个元素的操作，对应相机开发场景，几乎都是获取可用相机列表后没有做非空校验，直接取第一个元素导致的。

排查步骤 #

• 第一步：校验权限申请逻辑 #

  调用相机前必须先申请相机、麦克风（拍视频需要）权限，未拿到权限时获取相机列表会返回空或null。需确保权限申请是异步等待完成后再执行后续相机逻辑，不要跳过await直接执行。可以使用permission_handler包处理权限，参考代码：

  // 申请相机权限
  PermissionStatus cameraPermission = await Permission.camera.request();
  if (!cameraPermission.isGranted) {
    // 权限被拒绝时终止后续逻辑，给出用户提示
    return;
  }
  // 拍视频需额外申请麦克风权限
  PermissionStatus micPermission = await Permission.microphone.request();
  if (!micPermission.isGranted) {
    return;
  }
  

• 第二步：校验相机列表非空逻辑 #

  调用availableCameras()获取设备相机列表后，必须先判断列表非空再取下标元素，禁止直接写cameras[0]，参考代码：

  final List<CameraDescription> cameras = await availableCameras();
  if (cameras == null || cameras.isEmpty) {
    // 未检测到可用相机时终止后续逻辑，给出用户提示
    return;
  }
  // 确认列表非空后再取第一个相机（一般是后置摄像头）
  CameraDescription mainCamera = cameras[0];
  

• 第三步：校验相机控制器初始化逻辑 #

  相机控制器的initialize()方法是异步操作，必须等待初始化完成后再调用拍摄、预览相关方法，避免控制器未初始化完成引发空指针，参考代码：

  _cameraController = CameraController(
    mainCamera,
    ResolutionPreset.high,
  );
  // 等待控制器初始化完成
  await _cameraController.initialize();
  // 初始化完成后再刷新界面渲染CameraPreview组件
  if (mounted) setState(() {});
  

平台配置校验 #

• Android平台：确认android/app/src/main/AndroidManifest.xml中已添加相机、麦克风、存储权限声明
• iOS平台：确认ios/Runner/Info.plist中已添加NSCameraUsageDescription、NSMicrophoneUsageDescription权限使用描述
• 不要在initState中同步执行相机初始化逻辑，要单独封装异步初始化函数，在initState中调用即可。

内容的提问来源于stack exchange，提问作者Maahdi.Codes