iOS Swift中使用Alamofire调用API时响应Key值位置随机变更问题

问题根源 #

Swift标准库的Dictionary基于哈希表实现，不保证键的存储/遍历顺序。Alamofire默认将JSON响应解析为[String: Any]类型字典，会打乱服务器返回的原始键顺序；而浏览器、Postman直接渲染原始JSON字符串，因此能保留键的原始顺序。

解决方案 #

方法1：利用NSDictionary保留顺序（iOS 10+） #

从iOS 10/macOS 10.12开始，NSDictionary会保留键的插入顺序。通过JSONSerialization解析为NSDictionary即可获取原始顺序：

import Alamofire

AF.request("你的API地址").responseData { response in
    guard let data = response.data else { return }
    do {
        // 解析为NSDictionary，保留原始键顺序
        guard let rootDict = try JSONSerialization.jsonObject(with: data, options: .mutableContainers) as? NSDictionary,
              let tableData = rootDict["tableData"] as? NSDictionary else {
            return
        }
        
        // 获取有序的键数组
        let orderedKeys = tableData.allKeys as! [String]
        for key in orderedKeys {
            let value = tableData[key]
            // 根据业务需求处理每个键值对
            print("键：\(key)，值：\(value ?? "无值")")
        }
    } catch {
        print("JSON解析失败：\(error.localizedDescription)")
    }
}

方法2：使用OrderedDictionary（Swift化方案） #

苹果官方OrderedCollections框架提供的OrderedDictionary会严格保留键的插入顺序，适合Swift风格的开发：

1. 先通过Swift Package Manager或CocoaPods引入OrderedCollections依赖
2. 代码实现：

import Alamofire
import OrderedCollections

AF.request("你的API地址").responseData { response in
    guard let data = response.data else { return }
    do {
        guard let rootDict = try JSONSerialization.jsonObject(with: data) as? [String: Any],
              let tableDataDict = rootDict["tableData"] as? [String: Any] else {
            return
        }
        
        // 将普通字典转为有序字典
        let orderedTableData = OrderedDictionary(uniqueKeysWithValues: tableDataDict)
        
        // 遍历有序字典，顺序与服务器返回一致
        for (key, value) in orderedTableData {
            print("键：\(key)，值：\(value)")
        }
    } catch {
        print("JSON解析失败：\(error.localizedDescription)")
    }
}

注意事项 #

• JSON规范本身不要求键的顺序具有语义，若业务强依赖键顺序，建议和后端确认是否能通过数组等结构传递顺序信息，避免依赖非标准行为。
• 动态键场景无法使用JSONDecoder解析固定模型，必须通过上述字典解析方式处理。

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