Alamofire新手求助：如何处理成功响应中的错误？

嘿，刚接触Alamofire和JSON不用慌，我来帮你捋捋怎么处理这种服务器返回的业务错误～

你遇到的是业务逻辑错误——服务器可能返回了2xx的HTTP状态码（所以Alamofire会进入success回调），但响应体里包含了error字段表示业务处理失败。这种情况不能只依赖Alamofire的HTTP错误拦截，得手动解析响应内容判断。

方法1：手动解析JSON字典（快速上手） #

你可以在Alamofire的success回调里，先判断响应字典中是否存在error字段，如果有就处理错误，否则处理正常的data数据：

import Alamofire

let url = "myurl"
let parameters = ["user_id": "123abc", ...] // 替换成你的实际参数

AF.request(url, method: .post, parameters: parameters)
    .responseJSON { response in
        switch response.result {
        case .success(let value):
            // 把响应内容转为字典格式
            guard let responseDict = value as? [String: Any] else {
                print("响应格式不符合预期，无法解析")
                return
            }
            
            // 优先检查是否存在业务错误
            if let errorDict = responseDict["error"] as? [String: Any] {
                let statusCode = errorDict["http_status_code"] as? Int ?? 0
                let errorMsg = errorDict["message"] as? String ?? "未知业务错误"
                let errorType = errorDict["type"] as? String ?? "unknown_error"
                
                print("业务处理失败：\(errorMsg)，错误类型：\(errorType)，状态码：\(statusCode)")
                // 这里可以给用户弹提示框，比如用UIAlertController展示错误信息
            } else if let dataDict = responseDict["data"] as? [String: Any] {
                // 解析正常返回的数据
                let cabinetId = dataDict["cabinet_id"] as? String ?? ""
                let createdAt = dataDict["created_at"] as? String ?? ""
                let userId = dataDict["user_id"] as? String ?? ""
                
                print("请求成功：柜ID \(cabinetId)，创建时间 \(createdAt)")
                // 这里处理你的正常业务逻辑，比如更新UI
            } else {
                print("响应格式异常，既无data也无error字段")
            }
        case .failure(let error):
            // 处理HTTP层面的错误，比如网络断开、404、500等
            print("HTTP请求失败：\(error.localizedDescription)")
        }
    }

方法2：用Codable优雅解析（推荐长期使用） #

如果项目里用Codable，可以定义对应的模型类/结构体，自动解析响应，代码更清晰且类型安全：

第一步：定义数据模型 #

// 正常返回的数据模型
struct CabinetData: Codable {
    let cabinetId: String
    let createdAt: String
    let userId: String
    
    // 映射JSON的蛇形命名到Swift的驼峰命名
    enum CodingKeys: String, CodingKey {
        case cabinetId = "cabinet_id"
        case createdAt = "created_at"
        case userId = "user_id"
    }
}

// 业务错误模型
struct ApiError: Codable {
    let httpStatusCode: Int
    let message: String
    let type: String
    
    enum CodingKeys: String, CodingKey {
        case httpStatusCode = "http_status_code"
        case message, type
    }
}

// 统一的API响应模型
struct ApiResponse: Codable {
    let data: CabinetData?
    let error: ApiError?
}

第二步：用模型解析响应 #

AF.request(url, method: .post, parameters: parameters)
    .responseDecodable(of: ApiResponse.self) { response in
        switch response.result {
        case .success(let apiResponse):
            if let error = apiResponse.error {
                // 处理业务错误
                print("业务处理失败：\(error.message)，错误类型：\(error.type)")
                // 这里可以把错误信息展示给用户
            } else if let data = apiResponse.data {
                // 处理正常数据
                print("请求成功：柜ID \(data.cabinetId)，创建时间 \(data.createdAt)")
                // 更新UI或处理业务逻辑
            } else {
                print("响应格式异常，无有效数据")
            }
        case .failure(let error):
            // 处理HTTP层面的错误
            print("HTTP请求出错：\(error.localizedDescription)")
        }
    }

额外提醒 #

• 为什么业务错误会进入success回调？因为有些服务器会把业务错误也返回2xx状态码（比如200），Alamofire只根据HTTP状态码判断请求是否成功，所以需要我们手动检查响应体里的error字段。
• 用Codable的好处是避免大量的类型转换和可选值判断，代码更易维护，也减少出错概率。

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