Swift中如何以x-www-form-urlencoded格式在POST请求中附加多组数据

没问题！我来帮你搞定Swift里用x-www-form-urlencoded格式发送POST请求的事儿，尤其是你要传递5组数据的场景。Postman里能正常工作，说明接口本身是支持这个格式的，咱们只需要在Swift代码里正确构造请求体就行。

核心思路 #

x-www-form-urlencoded格式本质是将键值对转换为key1=value1&key2=value2这样的字符串，并且会自动对特殊字符（比如空格、&、=等）进行URL编码。我们可以借助URLComponents来自动完成编码和拼接，避免手动处理出错。

完整代码示例 #

这里直接给你补全并优化代码，包含5组数据的构造、请求体生成和请求发送：

// 1. 确保URL有效
guard let url = URL(string: "替换成你的接口URL") else {
    print("⚠️ 无效的URL地址")
    return
}

// 2. 创建POST请求
var request = URLRequest(url: url)
request.httpMethod = "POST"
// 设置Content-Type头，这一步你已经写对了
request.setValue("application/x-www-form-urlencoded;charset=UTF-8", forHTTPHeaderField: "Content-Type")

// 3. 准备要传递的5组键值对数据
let postParameters = [
    "username": "VineeshTP",
    "email": "vineesh@example.com",
    "age": "30",
    "city": "Cochin",
    "skill": "iOS Development"
]

// 4. 将键值对转换为符合格式的请求体
var urlComponents = URLComponents()
// 把字典转成URLQueryItem数组，URLComponents会自动处理编码
urlComponents.queryItems = postParameters.map { key, value in
    URLQueryItem(name: key, value: value)
}

// 生成请求体数据并赋值给request
if let queryString = urlComponents.query, let httpBody = queryString.data(using: .utf8) {
    request.httpBody = httpBody
}

// 5. 发送请求（用URLSession示例）
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    // 处理请求错误
    if let error = error {
        print("❌ 请求失败: \(error.localizedDescription)")
        return
    }
    
    // 验证响应状态码
    guard let httpResponse = response as? HTTPURLResponse, (200...299).contains(httpResponse.statusCode) else {
        print("❌ 响应状态异常")
        return
    }
    
    // 解析响应内容
    if let data = data, let responseText = String(data: data, encoding: .utf8) {
        print("✅ 响应内容: \n\(responseText)")
    }
}
task.resume()

关键说明 #

• 为什么用URLComponents？它会自动帮我们处理特殊字符的URL编码（比如如果你的值里有空格、&这类字符，会自动转成%20、%26），这和Postman的处理逻辑一致，能避免编码错误导致请求失败。
• 如果你想手动拼接字符串（不推荐，容易出错），可以用addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)来单独处理每个值，再用&拼接，但还是建议用URLComponents更省心。

这样写出来的代码就和Postman里的请求逻辑完全一致了，应该能正常发送5组数据到接口啦。

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