Alamofire从源码浅析2种不符合实际需求的参数格式总结

目前公司的Swift项目网络请求使用的是第三方开源库Alamofire，在使用的过程中有遇到过2种参数格式无法正确传递到后端的情况；

1）参数包含空数组

直接会被过滤删除掉

2）参数包含二维数组

会把二维数组转换为一维数组

下面将结合Alamofire参数编码部分的源码来一步一步的分析为啥不满足这2种参数格式。

1、首先看下实际结果

这里有必要先说下测试接口使用 httpbin.org来进行测试的好处；因为它在被调用后可以返回服务端所接收到的所有参数；在我们这里仅仅调试参数，所以比使用抓包工具要更方便一些，可以直接查看print的结果。

1）发起一个网络请求

// GET请求

AF.request("http://httpbin.org/get", method: .get, parameters: ["name": "kang", "score": 90, "nulllArr": [], "twoDArr": [["1","2"],["3","4"]]]).responseJSON { (response) in
    switch response.result {
    case .success(let value):
        print(value)
    case .failure(let error):
        print(error)
    }
}

输出结果：

{
    args =     {
        name = kang;
        score = 90;
        "twoDArr[][]" =         (
            1,
            2,
            3,
            4
        );
    };
    headers =     {
        Accept = "*/*";
        "Accept-Encoding" = "br;q=1.0, gzip;q=0.9, deflate;q=0.8";
        "Accept-Language" = "en;q=1.0";
        Host = "httpbin.org";
        "User-Agent" = "Test/1.0 ( build:1; iOS 14.0.0) Alamofire/5.2.2";
        "X-Amzn-Trace-Id" = "Root=1-5f8d57cd-039301d94fe8ad1d6311287c";
    };
    origin = "";
    url = "http://httpbin.org/get?name=kang&score=90&twoDArr[][]=1&twoDArr[][]=2&twoDArr[][]=3&twoDArr[][]=4";
}

// POST请求

AF.request("http://httpbin.org/post", method: .post, parameters: ["name": "kang", "score": 90, "nulllArr": [], "twoDArr": [["1","2"],["3","4"]]]).responseJSON { (response) in
    switch response.result {
    case .success(let value):
        print(value)
    case .failure(let error):
        print(error)
    }
}

输出结果：

{
    args =     {
    };
    data = "";
    files =     {
    };
    form =     {
        name = kang;
        score = 90;
        "twoDArr[][]" =         (
            1,
            2,
            3,
            4
        );
    };
    headers =     {
        Accept = "*/*";
        "Accept-Encoding" = "br;q=1.0, gzip;q=0.9, deflate;q=0.8";
        "Accept-Language" = "en;q=1.0";
        "Content-Length" = 106;
        "Content-Type" = "application/x-www-form-urlencoded; charset=utf-8";
        Host = "httpbin.org";
        "User-Agent" = "Test/1.0 (; build:1; iOS 14.0.0) Alamofire/5.2.2";
        "X-Amzn-Trace-Id" = "Root=1-5f8e5cd1-5aa70b642cee70930c0eedd7";
    };
    json = "<null>";
    origin = "";
    url = "https://httpbin.org/post";
}

可以看到无论是GET还是POST，空数组被过滤掉了，以及二维数组变成了一维数组

2）通过抓包工具Charles验证

// GET请求抓包
image-20201019172543187.png

// POST请求抓包
image-20201019173944744.png

可以看到请求的参数以及接口返回的参数和上面print的结果是一样的：空数组nullArr不见了，二维数组twoDArr被转换成了一维数组。这和我们定义参数格式初衷不一样了，需要和后台的同事重新沟通定义参数格式。

2、源码调试分析

宿主工程目前是通过Pod管理第三方依赖库，并且Xcode12已经支持在同一个workspace下不同project之间进行断点调试。

前面的func调用不用看，我们直接看参数处理的部分：

ParameterEncoding.swift -> URLEncoding
// MARK: Encoding

public func encode(_ urlRequest: URLRequestConvertible, with parameters: Parameters?) throws -> URLRequest {
    var urlRequest = try urlRequest.asURLRequest()

    guard let parameters = parameters else { return urlRequest }
    
    // 根据请求方法不同判断处理参数是放在url后面还是body
    if let method = urlRequest.method, destination.encodesParametersInURL(for: method) {
        guard let url = urlRequest.url else {
            throw AFError.parameterEncodingFailed(reason: .missingURL)
        }

        if var urlComponents = URLComponents(url: url, resolvingAgainstBaseURL: false), !parameters.isEmpty {
            let percentEncodedQuery = (urlComponents.percentEncodedQuery.map { $0 + "&" } ?? "") + query(parameters)
            urlComponents.percentEncodedQuery = percentEncodedQuery
            urlRequest.url = urlComponents.url
        }
    } else {
        if urlRequest.value(forHTTPHeaderField: "Content-Type") == nil {
            urlRequest.setValue("application/x-www-form-urlencoded; charset=utf-8", forHTTPHeaderField: "Content-Type")
        }

        urlRequest.httpBody = Data(query(parameters).utf8)
    }

    return urlRequest
}

从上面源码可以看到，无论哪种请求方式都有调用到 query(parameters) 处理参数

处理参数的核心代码就是以下3个方法

private func query(_ parameters: [String: Any]) -> String {
    // 创建一个数组，参数类型是2个字符串的元组类型，用于分别存储key、value
    var components: [(String, String)] = []

    // 将参数key按照字母正序的方式排序，然后遍历每个key
    for key in parameters.keys.sorted(by: <) {
        let value = parameters[key]!
        // 根据value类型具体处理参数
        components += queryComponents(fromKey: key, value: value)
    }
    // 按照key1=value1&key2=value2的格式拼接返回参数字符串
    return components.map { "\($0)=\($1)" }.joined(separator: "&")
}

// 递归遍历参数的每一层，将其展开为一维
public func queryComponents(fromKey key: String, value: Any) -> [(String, String)] {
    // 创建一个数组，参数类型是2个字符串的元组类型，用于分别存储key、value
    var components: [(String, String)] = []
    // 根据参数字典中的value类型是字典、数组、整型、布尔分别处理
    switch value {
    case let dictionary as [String: Any]:
        for (nestedKey, value) in dictionary {
            components += queryComponents(fromKey: "\(key)[\(nestedKey)]", value: value)
        }
    case let array as [Any]:
        for value in array {
            components += queryComponents(fromKey: arrayEncoding.encode(key: key), value: value)
        }
    case let number as NSNumber:
        if number.isBool {
            components.append((escape(key), escape(boolEncoding.encode(value: number.boolValue))))
        } else {
            components.append((escape(key), escape("\(number)")))
        }
    case let bool as Bool:
        components.append((escape(key), escape(boolEncoding.encode(value: bool))))
    default:
        components.append((escape(key), escape("\(value)")))
    }
    return components
}

// 对特殊字符进行URL编码
public func escape(_ string: String) -> String {
    string.addingPercentEncoding(withAllowedCharacters: .afURLQueryAllowed) ?? string
}
1）对于我们测试参数，空数组"nulllArr": []

由于是一个空数组，里面没有任何参数，所以在方法queryComponents遍历后就直接返回一个空数组var components: [(String, String)] = [] 给 components += queryComponents(fromKey: key, value: value)，而这里数组的拼接必须是有元素才可以的，空数组是不会加过去的。

这里我们可以看看数组Array定义的 += 方法：

@frozen public struct Array<Element> {
   @inlinable public static func += (lhs: inout [Element], rhs: [Element])
}

在 https://swift.org/ 查看Swift源码stdlib--public--core--Array.swift可以看到

extension Array {
  @inlinable
  public static func += (lhs: inout Array, rhs: Array) {
    lhs.append(contentsOf: rhs)
  }
}

@inlinable
  @_semantics("array.append_element")
  public mutating func append(_ newElement: __owned Element) {
    _makeUniqueAndReserveCapacityIfNotUnique()
    let oldCount = _getCount()
    _reserveCapacityAssumingUniqueBuffer(oldCount: oldCount)
    _appendElementAssumeUniqueAndCapacity(oldCount, newElement: newElement)
  }

当rhs右边的数组有元素的时候数组buffer缓存才会加；这里说得有点偏了，如果感兴趣可以去仔细看看这个方法的具体实现。

2）对于二维数组："twoDArr": [["1","2"],["3","4"]]]

由于是二维，所以在执行方法queryComponents的时候会递归调用，将里面的元素全部展开变成了一维数组，"twoDArr [] [] ": ["1","2","3","4"]，对于key后面有2个中括号，这个是可以通过Alamofire下面代码进行控制的，默认情况下是带中括号的

public init(destination: Destination = .methodDependent,
            arrayEncoding: ArrayEncoding = .brackets,
            boolEncoding: BoolEncoding = .numeric) {
    self.destination = destination
    self.arrayEncoding = arrayEncoding
    self.boolEncoding = boolEncoding
}

public enum ArrayEncoding {
    case brackets
    case noBrackets

    func encode(key: String) -> String {
        switch self {
        case .brackets:
            return "\(key)[]"
        case .noBrackets:
            return key
        }
    }
}

由于我们这里是二维数组，所以方法queryComponents递归调用了2次，所以有2个中括号，也间接说明参数是一个二维数组参数。

总结

从实际参数请求结果到一步一步分析第三方库源码，我们找到了导致这个结果的具体原因。Alamofire参数处理有字典、数组、整型、布尔等，在本文中只是对空数组、二维数组进行了验证，其它类型原理是一样的，可以得出使用Alamofire发起网络请求：

1）参数中如果有空字典、空数组都会被过滤掉；
2）如果有字典、数组嵌套的情况，都会被一层层展开成一维；
3）参数key是按照字母正序进行排序的，如果某些接口对参数的顺序也有要求可以在key之前加入正序的字母。

在github上面，Alamofire/issues也有人遇到过类似本文参数的问题，参考官方评论使用Encodable类型而不用 Parameters 字典，经过验证还是存在这种参数格式问题，具体可以参看源码ParameterEncoder.swift去进行调试。

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,723评论 6赞 481
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,485评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 152,998评论 0赞 344
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,323评论 1赞 279
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,355评论 5赞 374
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,079评论 1赞 285
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,389评论 3赞 400
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,019评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,519评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,971评论 2赞 325
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,100评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,738评论 4赞 324
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,293评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,289评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,517评论 1赞 262
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,547评论 2赞 354
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,834评论 2赞 345