Dart：空List或Map执行类型转换时抛出错误

在从Firebase获取数据时，DocumentSnapshot.data()返回Object?类型，需将其转换为特定泛型的List或Map。但当原List/Map为空时，直接用as强转会抛出类型转换错误：

问题复现 #

空List场景 #

final list = [];
final result = list as List<Map<String, dynamic>?>;

错误输出：

type 'List<dynamic>' is not a subtype of type 'List<Map<String, dynamic>?>?' in type cast

空Map场景 #

final map = {};
final result = map as Map<String, dynamic>;

错误输出：

type '_Map<dynamic, dynamic>' is not a subtype of type 'Map<String, dynamic>' in type cast

问题原因 #

Dart中，空的[]默认实例化为List<dynamic>，空{}默认是Map<dynamic, dynamic>。由于Dart的泛型类型检查机制，List<dynamic>无法直接通过as强转为List<T>（即使列表为空），同理Map<dynamic, dynamic>也不能直接转换为Map<K,V>。

解决方案 #

一、空List的转换处理 #

方法1：使用List.castFrom

通过List.castFrom创建类型转换视图，支持空列表的安全转换：

final list = [];
final result = List.castFrom<dynamic, Map<String, dynamic>?>(list);

方法2：生成新的类型化列表

通过map遍历转换元素后生成新列表，空列表会直接返回目标类型的空列表：

final list = [];
final result = list.map((e) => e as Map<String, dynamic>?).toList();

Firebase场景下的安全处理

结合Firebase返回的Object?，先处理null情况再转换：

final snapshot = await FirebaseFirestore.instance.collection('xxx').doc('yyy').get();
final data = snapshot.data();
// 先获取列表，为空则用默认空列表兜底
final rawList = data?['target_list'] ?? [];
// 安全转换为目标类型
final typedList = rawList is List 
    ? rawList.cast<Map<String, dynamic>?>() 
    : <Map<String, dynamic>?>[];

二、空Map的转换处理 #

方法1：使用Map.castFrom

final map = {};
final result = Map.castFrom<dynamic, dynamic, String, dynamic>(map);

方法2：用Map.from创建新实例

Map.from会将原Map的键值对复制到新的类型化Map中，空Map会生成目标类型的空Map：

final map = {};
final result = Map<String, dynamic>.from(map);

Firebase场景下的安全处理

final snapshot = await FirebaseFirestore.instance.collection('xxx').doc('yyy').get();
final data = snapshot.data();
final rawMap = data?['target_map'] ?? {};
final typedMap = rawMap is Map 
    ? rawMap.cast<String, dynamic>() 
    : <String, dynamic>{};

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