Swift中Firestore子集合数据获取失败问题求助

看起来你已经能正确定位到目标课程文档，但子集合cards的数据一直拿不到，咱们一步步来排查问题：

首先，先确认几个基础问题 #

• 子集合路径是否完全正确？
  Firestore的集合/文档路径是大小写敏感的，而且必须严格对应控制台里的结构。比如你代码里写的是collection("cards")，要确认控制台里该课程文档下的子集合是不是真的叫cards（有没有写成Cards或者其他拼写错误？）。另外，要确保子集合是创建在具体课程文档下面，而不是直接挂在courses集合根目录下（比如错误路径是courses/cards，正确路径应该是courses/[课程文档ID]/cards）。

• 目标课程下真的有cards文档吗？
  打开Firestore控制台，找到你通过courseTitle匹配到的那个课程文档，点进去看看cards子集合里是不是真的有文档存在。有时候可能是数据存储时的路径写错了，导致子集合是空的。

• Firestore安全规则是否允许读取子集合？
  这是很容易忽略的点！如果你的安全规则只给了courses集合的读取权限，没覆盖子集合，那即使数据存在也读不到。比如默认规则可能只允许认证用户操作，但如果你的测试设备没登录，或者规则里没包含cards子集合的权限，就会获取失败。
  你可以先临时修改规则做测试（上线前一定要改回严格权限！）：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow read, write: if true;
      }
    }
  }
  

  如果改完规则后能拿到数据，就说明是权限问题，之后再把规则调整为符合你需求的版本（比如只允许认证用户读取，或者限定特定路径）。

然后，优化你的代码来辅助调试 #

你的代码里有个小问题：两个for循环都用了document作为变量名，虽然语法没问题，但容易混淆。另外，增加一些调试打印，能帮你更清楚地看到每一步的状态：

static func getCourseCards(courseTitle: String) async throws -> [[String:Any]] {
    let store = Firestore.firestore()
    var courseCards: [[String:Any]] = []
    
    do {
        let snapshot = try await store.collection("courses").whereField("Title", isEqualTo: courseTitle).getDocuments()
        
        // 先确认找到了几个匹配的课程文档
        print("匹配到的课程文档数量：\(snapshot.documents.count)")
        
        for courseDoc in snapshot.documents {
            print("当前课程文档数据：", courseDoc.data())
            print("当前课程文档完整路径：", courseDoc.reference.path)
            
            let cardsCollectionRef = courseDoc.reference.collection("cards")
            print("Cards子集合路径：", cardsCollectionRef.path)
            
            let subSnapshot = try await cardsCollectionRef.getDocuments()
            print("该课程下的Cards文档数量：\(subSnapshot.documents.count)")
            
            for cardDoc in subSnapshot.documents {
                print("Card文档数据：", cardDoc.data())
                courseCards.append(cardDoc.data())
            }
        }
    } catch {
        print("获取数据时出错：", error.localizedDescription)
        throw error // 这里建议把错误抛出去，让调用者处理，而不是只打印
    }
    
    print("最终获取到的Cards数据：", courseCards)
    return courseCards
}

运行这段代码后，看控制台的打印信息：

1. 如果匹配到的课程文档数量是0，说明你的whereField查询没找到对应的课程，要检查Title字段的取值是否和你传入的courseTitle完全一致（包括大小写、空格等）。
2. 如果该课程下的Cards文档数量是0，那要么是子集合里真的没数据，要么是路径/权限有问题。

最后再提个小建议 #

尽量不要用[[String:Any]]这种松散的类型，建议创建一个Card模型，把Firestore的数据解析成模型对象，这样代码更安全也更易维护。比如：

struct Card: Codable {
    let id: String
    let content: String
    // 其他你需要的字段
}

// 解析的时候可以这么写：
if let card = try? cardDoc.data(as: Card.self) {
    courseCards.append(card)
}

备注：内容来源于stack exchange，提问作者user3335696