使用Alamofire POST请求时，如何保留参数中的冒号字符？

这问题我之前对接特殊服务端时也碰到过！Alamofire默认的URLEncoding会按照URL规范对特殊字符（比如冒号:）进行百分号编码，所以你才会看到HTTPBody里的time=00%3A00%3A00（%3A就是冒号的编码值）。要让请求直接使用冒号本身，有两个实用的解决方案：

方案一：自定义URLEncoding实例，允许冒号不被编码 #

我们可以通过修改URLEncoding的allowedCharacters参数，把冒号加入到不需要编码的字符集合中：

// 1. 扩展URL查询允许的字符集合，加入冒号
let allowedCharacters = CharacterSet.urlQueryAllowed.insert(":")
// 2. 创建自定义编码规则，指定编码目标为HTTPBody
let customEncoding = URLEncoding(destination: .httpBody, allowedCharacters: allowedCharacters)

// 3. 使用自定义编码发送请求
let params = ["time":"00:00:00"]
Alamofire.request(url!, method: .post, parameters: params, encoding: customEncoding, headers: headers).responseJSON { response in
    // 验证HTTP Body内容
    if let bodyData = response.request?.httpBody, let bodyString = String(data: bodyData, encoding: .utf8) {
        print("HTTP Body: \(bodyString)") // 此时会输出 time=00:00:00
    }
}

方案二：手动构建HTTPBody（适合参数简单的场景） #

如果你的请求参数不多，也可以直接拼接符合要求的字符串，再转成Data作为HTTPBody发送：

// 直接构建符合服务端要求的body字符串
let bodyString = "time=00:00:00"
guard let bodyData = bodyString.data(using: .utf8) else {
    print("Failed to convert body string to data")
    return
}

// 发送请求时直接设置httpBody
Alamofire.request(url!, method: .post, headers: headers)
    .httpBody(bodyData)
    .responseJSON { response in
        // 处理响应逻辑
        if let bodyData = response.request?.httpBody, let bodyString = String(data: bodyData, encoding: .utf8) {
            print("HTTP Body: \(bodyString)")
        }
    }

补充说明 #

默认的CharacterSet.urlQueryAllowed不包含冒号，是因为URL规范里冒号属于保留字符，通常用于区分协议（比如http://）或端口号。但有些服务端没有严格遵循这个规范，要求参数直接使用原始冒号，这时候就需要我们自定义编码规则啦。

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