Flutter FutureBuilder异常行为：未执行if/else分支问题

核心问题分析 #

你遇到的分支代码未执行、仅打印外层日志的情况，大概率是两个原因导致：args的判断逻辑与实际值不匹配，或者分支内代码抛出未捕获的异常。结合你打印的"running future ...null"，先从args的实际状态入手排查。

步骤1：精准确认args的真实状态 #

先在debugPrint("running future ...$args")后添加详细打印，明确args的具体值和类型，避免判断条件和实际值不符：

Future<Tutor?> handleTutorData(dynamic args) async {
  debugPrint("running future ...$args");
  // 新增：打印args的详细状态
  debugPrint('args 实际值: $args, 是否为null: ${args == null}, 类型: ${args.runtimeType}');
  
  final prefs = await SharedPreferences.getInstance();
  
  if (args != null) {
    // 存入缓存逻辑
    debugPrint('进入存入分支');
    final tutorJson = (args as Tutor).toJson();
    await prefs.setString('tutor_data', jsonEncode(tutorJson));
    return args;
  } else {
    // 读取缓存逻辑
    debugPrint('进入读取分支');
    final tutorJson = prefs.getString('tutor_data');
    return tutorJson != null ? Tutor.fromJson(jsonDecode(tutorJson)) : null;
  }
}

如果打印显示args并非真正的null（比如是空的Tutor实例、空字符串等），那你的if (args != null)判断就不会进入预期分支，需要调整判断逻辑（比如改成if (args is Tutor && args.id != null)这类更精准的条件）。

步骤2：捕获分支内的异常 #

如果args状态符合预期，但分支代码仍不执行，大概率是代码抛出了未捕获的异常（比如Tutor的toJson/fromJson方法报错、SharedPreferences操作异常），需要添加try-catch捕获：

Future<Tutor?> handleTutorData(dynamic args) async {
  try {
    debugPrint("running future ...$args");
    debugPrint('args 实际值: $args, 是否为null: ${args == null}, 类型: ${args.runtimeType}');
    
    final prefs = await SharedPreferences.getInstance();
    
    if (args != null) {
      debugPrint('进入存入分支');
      final tutorJson = (args as Tutor).toJson();
      await prefs.setString('tutor_data', jsonEncode(tutorJson));
      return args;
    } else {
      debugPrint('进入读取分支');
      final tutorJson = prefs.getString('tutor_data');
      return tutorJson != null ? Tutor.fromJson(jsonDecode(tutorJson)) : null;
    }
  } catch (e, stackTrace) {
    // 打印异常信息，定位问题
    debugPrint('分支执行出错: $e');
    debugPrint('异常栈: $stackTrace');
    return null;
  }
}

步骤3：修复FutureBuilder重复执行问题 #

你提到打印了两次"Future is done ..."，说明future被重复创建了。要避免每次build都重新生成Future，需将其存到State变量中：

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

  @override
  State<YourPage> createState() => _YourPageState();
}

class _YourPageState extends State<YourPage> {
  late final Future<Tutor?> _tutorFuture;

  @override
  void initState() {
    super.initState();
    // 在initState中初始化future，避免重复执行
    final args = ModalRoute.of(context)?.settings.arguments;
    _tutorFuture = handleTutorData(args);
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<Tutor?>(
      future: _tutorFuture, // 使用预初始化的future
      builder: (context, snapshot) {
        // UI构建逻辑
        if (snapshot.connectionState == ConnectionState.done) {
          debugPrint('Future is done ...');
          return // 你的页面内容;
        }
        return const CircularProgressIndicator();
      },
    );
  }
}

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