Flutter/Dart中正确等待异步函数完成：相机初始化异常解决

问题背景 #

构建Flutter相机预览页面时，相机初始化是异步操作，若在初始化完成前访问CameraController，会触发late变量未初始化异常。当前用try-catch块临时规避，但代码不够优雅，希望找到更合理的解决方案。

优化方案：使用FutureBuilder处理异步状态 #

FutureBuilder是Flutter专门用于处理异步操作状态的组件，它能根据Future的执行状态（等待、完成、错误）返回对应UI，完美适配相机异步初始化的场景，替代冗余的try-catch逻辑。

修改后的完整代码 #

import 'package:flutter/material.dart';
import 'package:camera/camera.dart';

class CameraPreviewPage extends StatefulWidget {
  const CameraPreviewPage({super.key});

  @override
  State<CameraPreviewPage> createState() => _CameraPreviewPageState();
}

class _CameraPreviewPageState extends State<CameraPreviewPage> {
  // 存储相机初始化的Future，确保仅在initState中初始化一次
  late Future<void> _initializeCameraFuture;
  // 相机控制器改为可空类型，避免late未初始化风险
  CameraController? _cameraController;

  @override
  void initState() {
    super.initState();
    // 启动相机初始化流程
    _initializeCameraFuture = _initCamera();
  }

  // 重构初始化函数，返回Future便于FutureBuilder监听
  Future<void> _initCamera() async {
    final cameras = await availableCameras();
    final firstCamera = cameras.first;
    
    _cameraController = CameraController(
      firstCamera,
      ResolutionPreset.high,
      enableAudio: false,
    );

    // 执行相机初始化
    await _cameraController!.initialize();
  }

  @override
  void dispose() {
    // 控制器非空时再释放资源，避免空指针
    _cameraController?.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: FutureBuilder<void>(
        future: _initializeCameraFuture,
        builder: (context, snapshot) {
          switch (snapshot.connectionState) {
            case ConnectionState.done:
              // 初始化完成，显示相机预览或错误提示
              if (snapshot.hasError) {
                return Center(
                  child: Text('相机初始化失败：${snapshot.error}'),
                );
              }
              return CameraPreview(_cameraController!);
            case ConnectionState.waiting:
              // 初始化中，显示加载指示器
              return const Center(child: CircularProgressIndicator());
            default:
              // 其他状态返回空布局
              return const SizedBox();
          }
        },
      ),
    );
  }
}

方案优势 #

• 状态清晰：通过FutureBuilder明确区分初始化的三种状态，给用户更直观的反馈（加载中、预览、错误提示）
• 避免异常：仅在初始化完成后才渲染CameraPreview，从根源上杜绝late变量未初始化的问题
• 代码简洁：去掉冗余的try-catch逻辑，代码结构更符合Flutter异步编程规范

注意事项 #

• _initializeCameraFuture必须在initState中初始化，避免每次build时重新创建Future导致重复初始化
• 释放资源时需检查_cameraController是否为空，防止空指针异常
• 记得处理初始化失败的场景，提升用户体验

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