Flutter中Future<List<Exercise>>无法赋值给可空类型参数的问题求助

问题 #

从Cloud Firestore数据库获取数据时遇到类型不匹配错误：

The argument type 'Future<List>' can't be assigned to the parameter type 'Future<List>?'

报错位置代码片段：

child: FutureBuilder<List<Exercise>>(
   future: FirestoreService().getExercises(),
   builder: (context, snapshot)

完整代码 #

exercise_list.dart

class ExerciseList extends StatelessWidget {
  const ExerciseList({super.key});

  @override
  Widget build(BuildContext context) {
    return Expanded(
      child: DecoratedBox(
        decoration: const BoxDecoration(
          color: Colors.white,
        ),
        child: Padding(
          padding: const EdgeInsets.symmetric(vertical: 20, horizontal: 30),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Expanded(
                child: FutureBuilder<List<Exercise>>(
                  future: FirestoreService().getExercises(),
                  builder: (context, snapshot) {
                    if (snapshot.hasError) {
                      return const Text('Something went wrong');
                    }

                    if (snapshot.connectionState == ConnectionState.waiting) {
                      return const Center(
                        child: CircularProgressIndicator(),
                      );
                    }

                    return ListView.builder(
                      itemCount: snapshot.data!.length,
                      itemBuilder: (context, index) => ExerciseItem(
                        exercise: snapshot.data![index],
                      ),
                    );
                  },
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

firestore.dart 相关代码

/// Reads all documents from the exercises collection
Future<List<Exercise>> getExercises() async {
  var ref = _db.collection('exercises');
  var snapshot = await ref.get();
  var data = snapshot.docs.map((s) => s.data());
  var exercises = data.map((d) => Exercise.fromJson(d));
  return exercises.toList();
}

报错原因 #

错误中的Future<List<Exercise>>?是可空的Future类型，而getExercises()返回的是非可空的Future<List<Exercise>>。虽然Dart空安全规则允许非可空类型赋值给可空参数，但在类型推导严格校验或依赖库版本差异的场景下，会触发这个不匹配提示。

另外补充一个潜在问题：在build方法中直接调用FirestoreService().getExercises()，会导致Widget每次重建时重复发起Firestore请求，浪费资源。

解决方法 #

提供两种简单的修复方案，任选其一即可：

方案1：显式转换参数类型 #

在FutureBuilder的future参数处，将返回值转为可空类型：

FutureBuilder<List<Exercise>>(
  future: FirestoreService().getExercises() as Future<List<Exercise>>?,
  // 后续builder逻辑保持不变
)

方案2：修改方法返回类型 #

调整firestore.dart中的方法返回类型，使其与参数要求匹配：

Future<List<Exercise>>? getExercises() async {
  var ref = _db.collection('exercises');
  var snapshot = await ref.get();
  var data = snapshot.docs.map((s) => s.data());
  var exercises = data.map((d) => Exercise.fromJson(d));
  return exercises.toList();
}

额外优化：避免重复请求 #

将ExerciseList改为StatefulWidget，在initState中提前初始化Future，避免每次重建都发起请求：

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

  @override
  State<ExerciseList> createState() => _ExerciseListState();
}

class _ExerciseListState extends State<ExerciseList> {
  late Future<List<Exercise>> _exercisesFuture;

  @override
  void initState() {
    super.initState();
    _exercisesFuture = FirestoreService().getExercises();
  }

  @override
  Widget build(BuildContext context) {
    return Expanded(
      // 原有布局代码保持不变
      child: FutureBuilder<List<Exercise>>(
        future: _exercisesFuture,
        // 原有builder逻辑保持不变
      ),
    );
  }
}

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