Flutter中Firestore嵌套Map的添加、检索与遍历实现问题

1. 点击「参与」按钮时添加挑战历史记录 #

你可以利用现有challenges字段的递增数值生成新挑战的唯一键（比如challenge-${新的challenges值}），通过Firestore的嵌套Map更新语法添加新记录。修改后的代码如下：

// 计算新挑战的编号（challenges字段即将+1，新编号就是原数值+1）
int newChallengeNum = loggedInUser.challenges! + 1;
String newChallengeKey = "challenge-$newChallengeNum";

// 构造新挑战的记录
Map<String, dynamic> newChallengeRecord = {
  "name": widget._challengeName,
  "date": DateTime.now().toIso8601String(), // 存储ISO格式时间，方便后续解析
  "isWin": false // 刚参与时默认未完成/未获胜，后续可根据挑战结果更新
};

// 执行Firestore更新操作
await FirebaseFirestore.instance.collection("Users").doc(user!.uid).update({
  'points': loggedInUser.points! + 3,
  'challenges': newChallengeNum,
  'challengeMember': FieldValue.arrayUnion([widget._challengeName]),
  // 嵌套Map的更新语法，直接指定路径添加新条目
  'challengeHistory.$newChallengeKey': newChallengeRecord
});

每次点击「参与」，会基于更新后的challenges数值生成连续的键（challenge-1、challenge-2...），并将新挑战记录添加到challengeHistory中。

2. 检索特定挑战的name信息 #

从Firestore获取用户文档后，直接通过嵌套键访问目标挑战的name字段，同时处理字段不存在的情况：

// 获取用户文档
DocumentSnapshot userDoc = await FirebaseFirestore.instance.collection("Users").doc(user!.uid).get();
Map<String, dynamic> userData = userDoc.data() as Map<String, dynamic>;

// 检索第四个挑战的name
String? targetChallengeName = userData['challengeHistory']?['challenge-4']?['name'];
if (targetChallengeName != null) {
  print("第四个挑战名称：$targetChallengeName");
} else {
  print("未找到第四个挑战记录");
}

3. 遍历整个challengeHistory并打印信息 #

将challengeHistory转为Map后，使用forEach遍历所有条目：

// 获取用户文档并提取challengeHistory
DocumentSnapshot userDoc = await FirebaseFirestore.instance.collection("Users").doc(user!.uid).get();
Map<String, dynamic> userData = userDoc.data() as Map<String, dynamic>;
Map<String, dynamic> challengeHistory = userData['challengeHistory'] as Map<String, dynamic>;

// 遍历并打印每个挑战信息
challengeHistory.forEach((key, challenge) {
  print("挑战编号：$key");
  print("名称：${challenge['name']}");
  print("参与日期：${challenge['date']}");
  print("是否获胜：${challenge['isWin']}");
  print("------------------------");
});

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