Flutter中FutureBuilder搭配Timer失效问题及代码排查求助

一、先拆解你第一个问题：getCommunitiesList_old 一直显示加载的原因 #

你的原始getCommunitiesList_old代码有两个致命漏洞：

1. Timer不能用await等待：Timer()构造函数返回的是Timer实例，不是Future对象——await只能作用于Future类型，所以这行await Timer(...)完全不会等待5秒，方法会立刻执行完毕，但又没有返回任何有效数据。
2. 回调里的return data根本传不出去：Timer的回调是void Function()类型，里面的return data没有任何意义——它不会被外层的async方法捕获，你的getCommunitiesList_old实际上没有返回任何List<CommunitieModel>，导致这个Future永远不会完成，FutureBuilder自然一直停在加载状态。

二、修正代码为什么能正常工作 #

Crazy Lazy Cat给的修正代码用了Future.delayed，这才是Flutter里实现延迟操作的正确姿势：

• Future.delayed返回的是标准Future对象，await可以正确等待指定时长。
• 延迟结束后，后续的创建列表、添加数据、return data逻辑会正常执行，最终把生成的列表作为Future的返回值，FutureBuilder就能拿到数据并更新UI。

三、解答你的第二个疑问：getTempleList为什么不能工作 #

你的getTempleList代码犯了两个关键错误：

1. Future.delayed的回调返回值没被外层方法传递出去：虽然你在Future.delayed的回调里创建了列表并return data，但外层的async方法没有把这个返回值return给调用者——你只是await了延迟，但没把生成的列表交出去。
2. 隐性类型不匹配：你的方法声明返回Future<List<SimpleCardModel>>，但如果没有显式return语句，async方法会默认返回Future<void>，这不仅会导致类型错误，还会让FutureBuilder拿不到预期的列表数据。

正确的写法应该是这样：

Future<List<SimpleCardModel>> getTempleList() async {
  // 等待1秒，同时获取回调返回的列表
  final data = await Future.delayed(const Duration(seconds: 1), () {
    List<SimpleCardModel> data = List();
    for (int i = 11; i < 44; i++) {
      data.add(SimpleCardModel(
        title: "Hi Temple $i",
        details: "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when ...",
        imageUrl: "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQufRouQz5g0chR_vkUnDPbYpYdorS5FtT6N9asmkp-MqhDscJ-&s"
      ));
    }
    return data;
  });
  // 把列表返回给调用者
  return data;
}

或者更简洁的写法，直接返回await的结果：

Future<List<SimpleCardModel>> getTempleList() async {
  return await Future.delayed(const Duration(seconds: 1), () {
    List<SimpleCardModel> data = List();
    for (int i = 11; i < 44; i++) {
      data.add(SimpleCardModel(
        title: "Hi Temple $i",
        details: "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when ...",
        imageUrl: "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQufRouQz5g0chR_vkUnDPbYpYdorS5FtT6N9asmkp-MqhDscJ-&s"
      ));
    }
    return data;
  });
}

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