Flutter中如何使用Firebase Firestore的FieldPath.of()更新嵌套文档字段

问题原因 #

你遇到的编译异常是Dart的Map字面量类型推断限制导致的：Firebase的DocumentReference.update()方法接收的参数类型为Map<Object, Object?>，支持String和FieldPath两种类型的字段键，但你直接书写{fieldPath: _map}时，Dart会自动将这个Map推断为Map<FieldPath, dynamic>类型，和方法要求的参数类型不匹配，因此触发编译错误。

解决方法 #

方法1：显式指定Map键类型（使用FieldPath实例） #

你只需要在传入update方法时，显式声明Map的key类型为Object即可正常使用FieldPath实例作为更新键：

Map _map = {
  'name': 'vin',
  'quantity': 2,
  'costPrice': 12000,
};
var fieldPath = FieldPath(['categories', 'branch']);
final CollectionReference _storeRef =
    FirebaseFirestore.instance.collection('stores');
// 显式指定key类型为Object，兼容FieldPath类型
_storeRef.doc('6').update(<Object, dynamic>{fieldPath: _map});

方法2：使用点分隔字符串路径（简单场景可选） #

如果你的字段名称本身不包含.符号，也可以直接使用点分隔的字符串作为嵌套字段路径，写法更简洁：

Map _map = {
  'name': 'vin',
  'quantity': 2,
  'costPrice': 12000,
};
final CollectionReference _storeRef =
    FirebaseFirestore.instance.collection('stores');
_storeRef.doc('6').update({'categories.branch': _map});

注意事项 #

当你的字段名称本身包含.符号时，必须使用FieldPath构造字段路径，避免Firebase将字段名中的点识别为嵌套层级分隔符。

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