Firestore用户分类数据存储方案咨询：扩展性与查询优化

针对你提出的两种数据结构，结合可扩展性与查询效率，具体分析和最优选择如下：

方案一：Categories 集合 → 用户ID文档（内部用Map存储分类） #

适用场景 #

用户分类数量较少（几十到上百个），且短期内不需要给分类添加复杂属性（如创建时间、排序权重）。

优缺点 #

• 优点：读取用户所有分类仅需一次文档读取，读写效率极高；结构简单，客户端实现成本低。
• 缺点：单文档最大限制1MB，分类过多会触发容量超限；无法单独查询/更新单个分类，必须全量读取后在客户端过滤；扩展性差，新增分类属性时需要修改整个Map结构。

Swift 代码示例（基于Codable） #

struct Category: Codable {
    let id: String
    let title: String
    let imageURL: String
}

// 保存分类到用户文档的Map中
func saveUserCategories(userId: String, categories: [Category]) {
    let categoryMap = categories.reduce(into: [String: [String: Any]]()) { result, category in
        result[category.id] = [
            "title": category.title,
            "imageURL": category.imageURL
        ]
    }
    
    Firestore.firestore()
        .collection("Categories")
        .document(userId)
        .setData(["categories": categoryMap], merge: true) { error in
            if let error = error {
                print("保存失败：\(error.localizedDescription)")
            }
        }
}

// 读取用户所有分类
func loadUserCategories(userId: String, completion: @escaping ([Category]?) -> Void) {
    Firestore.firestore()
        .collection("Categories")
        .document(userId)
        .getDocument { snapshot, error in
            guard let data = snapshot?.data(), 
                  let categoryMap = data["categories"] as? [String: [String: Any]] else {
                completion(nil)
                return
            }
            
            let categories = categoryMap.compactMap { id, info in
                guard let title = info["title"] as? String,
                      let imageURL = info["imageURL"] as? String else { return nil }
                return Category(id: id, title: title, imageURL: imageURL)
            }
            completion(categories)
        }
}

方案二：Categories 集合 → 用户ID文档 → UserCategories 子集合（分类ID为文档） #

适用场景 #

用户分类数量可能较多，或未来需要给分类添加更多属性（如创建时间、排序值）、支持复杂查询（如按创建时间排序）。

优缺点 #

• 优点：每个分类是独立文档，无容量限制；可单独查询/更新单个分类，支持排序、筛选等复杂操作；扩展性极强，新增属性仅需修改分类文档结构。
• 缺点：读取所有分类需要一次集合查询（Firestore集合查询效率足够支撑常规规模）；结构比方案一稍复杂，但维护成本更低。

Swift 代码示例（基于Codable） #

struct Category: Codable {
    let id: String
    let title: String
    let imageURL: String
    let createdAt: Timestamp // 新增属性示例
}

// 保存单个分类
func saveUserCategory(userId: String, category: Category) {
    do {
        try Firestore.firestore()
            .collection("Categories")
            .document(userId)
            .collection("UserCategories")
            .document(category.id)
            .setData(from: category)
    } catch {
        print("保存失败：\(error.localizedDescription)")
    }
}

// 读取用户所有分类（按创建时间排序）
func loadUserCategories(userId: String, completion: @escaping ([Category]?) -> Void) {
    Firestore.firestore()
        .collection("Categories")
        .document(userId)
        .collection("UserCategories")
        .order(by: "createdAt", descending: true)
        .getDocuments { snapshot, error in
            guard let docs = snapshot?.documents else {
                completion(nil)
                return
            }
            
            let categories = docs.compactMap { try? $0.data(as: Category.self) }
            completion(categories)
        }
}

关键补充：安全规则配置 #

无论选哪种方案，必须通过Firestore安全规则限制用户只能访问自己的分类：

// 方案一规则
match /Categories/{userId} {
  allow read, write: if request.auth != null && request.auth.uid == userId;
}

// 方案二规则
match /Categories/{userId}/UserCategories/{categoryId} {
  allow read, write: if request.auth != null && request.auth.uid == userId;
}

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