如何在Dart/Flutter中克隆Future？实现自定义FutureBuilder重运行

核心问题在于Future是一次性执行对象，一旦它完成（成功或失败），再次复用该实例不会触发新的异步操作。要实现重试功能，你不能直接传入Future实例，而是需要传入一个能生成新Future的函数，这样每次需要重试时，都能通过调用该函数创建全新的Future实例。

修改方案步骤： #

1. 调整组件构造参数类型：将原本的Future<T>参数改为Future<T> Function()（返回Future的函数），确保每次需要执行异步操作时都能生成新实例。
2. 初始化与更新逻辑：在initState和didUpdateWidget中，通过调用该函数初始化或更新_future。
3. 重试按钮逻辑：点击“重新加载”时，在setState中重新调用函数生成新Future，触发FutureBuilder重新执行。

修改后的完整代码： #

import 'package:flutter/material.dart';

class CustomFutureBuilder<T> extends StatefulWidget {
  // 替换原Future参数为返回Future的函数
  final Future<T> Function() futureFactory;

  const CustomFutureBuilder({super.key, required this.futureFactory});

  @override
  State<CustomFutureBuilder<T>> createState() => _CustomFutureBuilderState<T>();
}

class _CustomFutureBuilderState<T> extends State<CustomFutureBuilder<T>> {
  late Future<T> _future;

  @override
  void initState() {
    // 调用函数生成初始Future
    _future = widget.futureFactory();
    super.initState();
  }

  @override
  void didUpdateWidget(covariant CustomFutureBuilder<T> oldWidget) {
    // 若生成函数发生变化，重新生成Future
    if (oldWidget.futureFactory != widget.futureFactory) {
      _future = widget.futureFactory();
    }
    super.didUpdateWidget(oldWidget);
  }

  // 重试逻辑封装
  void _reload() {
    setState(() {
      // 生成新的Future实例
      _future = widget.futureFactory();
    });
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: _future,
      builder: (context, snapshot) {
        if (snapshot.connectionState != ConnectionState.done) {
          return const LinearProgressIndicator();
        }
        if (snapshot.hasError) {
          debugPrint('Loading error: ${snapshot.error}');
          return Column(
            children: [
              const Text(
                  '加载出错，请检查网络连接或稍后重试。'),
              OutlinedButton(
                onPressed: _reload,
                child: const Text('重新加载'),
              ),
            ],
          );
        }

        final data = snapshot.data as T;
        // 这里替换为你的数据展示组件，示例：
        return Text(data.toString());
      },
    );
  }
}

使用示例： #

使用组件时，需传入返回Future的函数，而非直接传Future实例：

CustomFutureBuilder<String>(
  futureFactory: () => fetchData(), // fetchData为你的异步请求函数
  // 其他配置
)

这样每次点击“重新加载”按钮，都会生成新的Future实例并执行异步操作，彻底解决原Future“已耗尽”无法重复执行的问题。

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