Swift中Firebase数据库结构设计及指定District文档查询方法

明确Firestore数据结构 #

先对齐符合Firestore层级规则的结构（Firestore要求集合与文档交替嵌套）：

• 顶层集合：products
• 集合内文档：代表国家（建议用国家代码作为文档ID，如"CN"）
• 国家文档的子集合：districts
• districts内文档：代表地区（district）（建议用地区标识作为文档ID，如"Guangdong"）
• 地区文档的子集合：cities
• cities内文档：代表城市，每个城市文档下包含各类业务子集合

实现步骤与代码示例 #

1. 导入Firebase依赖 #

确保项目已集成Firebase Firestore，在需要的文件中导入：

import FirebaseFirestore
import FirebaseFirestoreSwift

2. 定义城市数据模型（可选但推荐） #

将Firestore文档映射为Swift对象，定义符合Codable的模型：

struct City: Identifiable, Codable {
    @DocumentID var id: String? // 对应Firestore文档ID
    var name: String
    var population: Int?
    // 按需添加其他城市相关字段
}

3. 查询指定District下的所有城市文档 #

方式1：一次性获取数据（适合小数据量场景）

func fetchCitiesInDistrict(countryID: String, districtID: String) async throws -> [City] {
    let db = Firestore.firestore()
    // 构造完整查询路径
    let collectionRef = db.collection("products")
        .document(countryID)
        .collection("districts")
        .document(districtID)
        .collection("cities")
    
    // 获取集合内所有文档
    let querySnapshot = try await collectionRef.getDocuments()
    
    // 将文档数据映射为City对象
    return try querySnapshot.documents.map { document in
        try document.data(as: City.self)
    }
}

方式2：实时监听数据变化（SwiftUI实时更新场景）

使用@FirestoreQuery属性包装器实现UI实时同步：

struct CitiesView: View {
    let countryID: String
    let districtID: String
    
    // 实时监听指定district下的cities集合
    @FirestoreQuery var cities: [City]
    
    init(countryID: String, districtID: String) {
        self.countryID = countryID
        self.districtID = districtID
        // 初始化查询路径
        _cities = FirestoreQuery(
            collectionPath: "products/\(countryID)/districts/\(districtID)/cities"
        )
    }
    
    var body: some View {
        List(cities) { city in
            VStack(alignment: .leading) {
                Text(city.name)
                    .font(.headline)
                if let population = city.population {
                    Text("人口：\(population)")
                        .font(.subheadline)
                }
            }
        }
        .navigationTitle("城市列表")
        // 显示加载错误
        .overlay {
            if let error = _cities.error {
                Text("加载失败：\(error.localizedDescription)")
                    .foregroundColor(.red)
            }
        }
    }
}

4. 关键注意事项 #

• 路径正确性：确保集合、文档ID与Firestore后台完全一致，避免拼写错误
• 权限配置：在Firebase控制台的Firestore规则中，开放目标集合的读取权限，示例规则：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /products/{country}/districts/{district}/cities/{city} {
      allow read: if request.auth != null; // 根据业务需求调整权限逻辑
    }
  }
}

• 分页优化：城市数据量较大时，建议添加分页查询避免一次性加载过多数据：

func fetchCitiesWithPagination(countryID: String, districtID: String, lastDocument: DocumentSnapshot?) async throws -> (cities: [City], lastDocument: DocumentSnapshot?) {
    let db = Firestore.firestore()
    var query = db.collection("products/\(countryID)/districts/\(districtID)/cities")
        .limit(to: 10)
    
    if let lastDoc = lastDocument {
        query = query.start(afterDocument: lastDoc)
    }
    
    let snapshot = try await query.getDocuments()
    let cities = try snapshot.documents.map { try $0.data(as: City.self) }
    return (cities, snapshot.documents.last)
}

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