cloud_firestore更新数据报错：需用FieldPath.of()处理特殊字符字段名

Cloud Firestore 对字段名存在字符限制，字段名中如果包含 ~、*、/、[、] 这几个特殊字符，不能直接以普通字符串的形式作为键传入写入、更新方法，否则就会抛出对应错误。代码中使用的字段名 compus/not 包含受限字符 /，是触发报错的直接原因。

根据业务场景二选一即可：

• 方案1：更换字段名（推荐）
  最简便、后续维护成本最低的方式是直接修改字段名，去掉受限的特殊字符，比如将compus/not改为语义清晰且无特殊字符的studyMode、campusStatus等。修改后更新代码中对应的键即可，示例代码片段：

await firestore.collection('/users').doc(auth.currentUser?.uid).update({
  'About': about ?? '',
  'skills': skills ?? [],
  'discipline': discipline ?? [],
  // 替换为不含特殊字符的字段名
  'studyMode': campusCheck ? "Online" : "Campus",
  'workExperience': workExperience ?? [],
  'certificate': certificate ?? [],
  'level': level ?? '',
  'done': true
});

• 方案2：保留原带特殊字符的字段名
  如果业务要求必须保留compus/not这个字段名，按照报错提示使用FieldPath.of()方法构造合法字段路径即可，不要直接用字符串作为键。注意需要先导入cloud_firestore包，修改后的代码片段：

// 确保已导入包: import 'package:cloud_firestore/cloud_firestore.dart';
await firestore.collection('/users').doc(auth.currentUser?.uid).update({
  'About': about ?? '',
  'skills': skills ?? [],
  'discipline': discipline ?? [],
  // 使用FieldPath.of包裹含特殊字符的字段名
  FieldPath.of(['compus/not']): campusCheck ? "Online" : "Campus",
  'workExperience': workExperience ?? [],
  'certificate': certificate ?? [],
  'level': level ?? '',
  'done': true
});

注意：如果选择方案2，后续所有对该字段的读写操作都需要使用FieldPath.of(['compus/not'])的方式定位字段，直接传字符串'compus/not'会被Firestore识别为嵌套路径（即compus字段下的not子字段），导致读写错误。

内容的提问来源于stack exchange，提问作者Gbenga B Ayannuga