如何让Flutter的FutureBuilder感知异步任务中的异常？

问题分析 #

你当前的代码存在两个关键问题：

• 在_initialize方法里用try-catch直接吞掉了异常，导致Future以成功完成的状态结束，FutureBuilder无法感知到错误
• 当尝试显示错误信息时，使用了const Text(snapshot.error.toString())，但const要求内容编译时确定，而snapshot.error是运行时动态值，这会触发错误导致应用崩溃

解决方案 #

1. 让Future传递异常给FutureBuilder

修改_initialize方法，捕获异常后不要直接忽略，而是重新抛出（可以先添加日志等自定义操作）：

Future<void> _initialize() async {
  await Future.delayed(const Duration(seconds: 2));
  try {
    throw Exception("Error");
  } catch (e) {
    // 可在此添加日志记录等操作
    rethrow; // 重新抛出异常，让Future携带异常状态传递给FutureBuilder
  }
}

2. 修复Text组件的const错误

显示错误信息时，必须去掉const，因为动态内容无法用const修饰：

if (snapshot.hasError) {
  return Text(snapshot.error.toString()); // 移除const关键字
}

3. 额外优化：避免异步任务重复执行

由于你使用的是StatelessWidget，每次组件build都会重新调用_initialize创建新的Future，导致异步任务重复执行。建议改成StatefulWidget，将Future存储在state中，只执行一次：

import 'package:flutter/material.dart';

void main() {
  runApp(const MainApp());
}

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

  @override
  State<MainApp> createState() => _MainAppState();
}

class _MainAppState extends State<MainApp> {
  late final Future<void> _initFuture;

  @override
  void initState() {
    super.initState();
    _initFuture = _initialize(); // 仅在初始化时执行一次异步任务
  }

  Future<void> _initialize() async {
    await Future.delayed(const Duration(seconds: 2));
    try {
      throw Exception("Error");
    } catch (e) {
      rethrow;
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: FutureBuilder(
          future: _initFuture, // 使用存储的Future，避免重复执行
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.done) {
              if (snapshot.hasError) {
                return Text(snapshot.error.toString());
              }
              return const Text("Completed");
            }
            return const CircularProgressIndicator();
          },
        ),
      ),
    );
  }
}

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