iOS使用REST API解码Firebase Firestore嵌套Map字段问题

你当前代码无法正确解析user_metrics的核心问题有两个：

• MapValue结构体定义和Firestore返回结构不匹配：你将其定义为存储字符串类型，但实际mapValue节点下还有fields层包裹所有业务字段，每个字段还嵌套了Firestore固定的类型包装（integerValue/stringValue/doubleValue）。
• user_metrics属性类型声明错误：当前声明为[String]字符串数组，但实际该字段是结构化的指标对象数组，类型完全不匹配。

1. 定义匹配结构与业务模型 #

替换原有错误的MapValue定义，补充Firestore类型包装结构、以及业务层使用的指标模型：

// 业务层直接使用的指标模型，和返回的业务字段一一对应
struct UserMetric: Codable {
    let point1: Int
    let point2: Int
    let metricDescription: String
    let metricResult: Double
    let metricDescriptionEn: String
    let metricTitle: String
}

// 匹配Firestore mapValue节点结构
struct FirestoreMapValue: Codable {
    let fields: MetricFields
}

// 匹配mapValue下的fields节点，处理每个字段的类型包装
struct MetricFields: Codable {
    let point1: FirestoreIntegerValue
    let point2: FirestoreIntegerValue
    let metricDescription: FirestoreStringValue
    let metricResult: FirestoreDoubleValue
    let metricDescriptionEn: FirestoreStringValue
    let metricTitle: FirestoreStringValue
    
    // 便捷方法转成业务层可用的模型
    func toDomain() -> UserMetric {
        UserMetric(
            point1: Int(point1.integerValue) ?? 0,
            point2: Int(point2.integerValue) ?? 0,
            metricDescription: metricDescription.stringValue,
            metricResult: metricResult.doubleValue,
            metricDescriptionEn: metricDescriptionEn.stringValue,
            metricTitle: metricTitle.stringValue
        )
    }
}

// Firestore 基础类型包装结构
struct FirestoreIntegerValue: Codable {
    let integerValue: String
}

struct FirestoreStringValue: Codable {
    let stringValue: String
}

struct FirestoreDoubleValue: Codable {
    let doubleValue: Double
}

2. 修正关联结构体定义 #

将原有ValueMetric中的mapValue属性类型替换为新定义的FirestoreMapValue：

struct ValueMetric: Codable {
    let mapValue : FirestoreMapValue
}

3. 修正属性类型与解码逻辑 #

首先修改Session_Struct中user_metrics的属性声明：

// 原代码：let user_metrics : [String]
// 替换为：
let user_metrics : [UserMetric]

然后替换init(from:)中user_metrics的解码赋值代码：

user_metrics = try fieldContainer.decode(MapMetrics.self, forKey: .user_metrics)
    .arrayValue.values.map { $0.mapValue.fields.toDomain() }

• Firestore REST API返回的JSON自带固定类型包装层，建议将Firestore格式解析结构和业务模型完全拆分，解码完成后直接转成纯业务模型供上层使用，避免业务代码中到处处理Firestore的类型包装逻辑，降低后续维护成本。
• 如果接口可能返回字段缺失的情况，可将MetricFields中的对应属性声明为可选类型，解码时使用decodeIfPresent，避免单个字段缺失导致整个响应解码失败。

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