iOS Swift中如何在HTTP POST请求中以QueryParam形式传递JSON对象参数？

我来帮你搞定这个问题！你遇到的核心问题是参数传递方式不对——后端用@QueryParam接收profileDetail，意味着这个JSON对象得作为URL查询参数传递，而不是塞进POST请求的Body里。你之前的Swift代码把JSON放到了httpBody，这和后端的接收逻辑不匹配，所以才会拿到null。

下面分别给出基于URLSession和Alamofire的解决方案：

方案一：使用URLSession实现 #

核心步骤： #

1. 把你的字典数据序列化为JSON字符串
2. 对JSON字符串进行URL编码（避免特殊字符破坏URL结构）
3. 将编码后的字符串拼接到URL的查询参数中
4. 构造POST请求（无需设置httpBody，因为参数已经在URL里）

完整代码示例：

// 1. 构造要传递的JSON字典
let jsonDict: [String: String] = [
    "PIDNO": defaults.value(forKey: "pidno") as? String ?? "",
    "GENDER": gender!,
    "TENANTNAME": txtTenantName.text ?? "",
    "EMAIL": txtEmailId.text ?? "",
    "OFFPHONE": officeMobile.text ?? "",
    "MOBILE": txtMobile.text ?? ""
]

// 2. 将字典转为JSON字符串
guard let jsonData = try? JSONSerialization.data(withJSONObject: jsonDict, options: []),
      let jsonString = String(data: jsonData, encoding: .utf8) else {
    print("Failed to convert dictionary to JSON string")
    return
}

// 3. 对JSON字符串进行URL编码，处理特殊字符
guard let encodedJsonString = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) else {
    print("Failed to encode JSON string")
    return
}

// 4. 拼接完整的请求URL（包含查询参数）
let baseUrl = SharedInstance.sharedInstance.url + "UpdateTenantProfile/UpdateTenantProfiledetails"
guard let requestUrl = URL(string: "\(baseUrl)?profileDetail=\(encodedJsonString)") else {
    print("Invalid request URL")
    return
}

// 5. 构造POST请求
var request = URLRequest(url: requestUrl)
request.httpMethod = "POST"
// 匹配后端@Consumes配置，设置Content-Type
request.addValue("application/json; charset=utf-8", forHTTPHeaderField: "Content-Type")

// 6. 发起请求并处理回调
_ = ActivityIndicator.show("Loading...".localized(), disableUI: true)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    DispatchQueue.main.async {
        ActivityIndicator.hide()
    }
    
    if let error = error {
        print("Request error: \(error.localizedDescription)")
        return
    }
    
    guard let responseData = data else {
        print("No response data received")
        return
    }
    
    do {
        let responseJson = try JSONSerialization.jsonObject(with: responseData, options: [])
        print("Success! Response: \(responseJson)")
        // 这里添加你的业务逻辑处理
    } catch {
        print("Failed to parse response: \(error.localizedDescription)")
    }
}
task.resume()

方案二：使用Alamofire实现 #

Alamofire可以更简洁地处理查询参数的编码和拼接，只需指定参数传递到URL查询字符串即可：

完整代码示例： #

import Alamofire

// 1. 构造要传递的JSON字典
let jsonDict: [String: String] = [
    "PIDNO": defaults.value(forKey: "pidno") as? String ?? "",
    "GENDER": gender!,
    "TENANTNAME": txtTenantName.text ?? "",
    "EMAIL": txtEmailId.text ?? "",
    "OFFPHONE": officeMobile.text ?? "",
    "MOBILE": txtMobile.text ?? ""
]

// 2. 将字典转为编码后的JSON字符串
guard let jsonData = try? JSONSerialization.data(withJSONObject: jsonDict, options: []),
      let jsonString = String(data: jsonData, encoding: .utf8),
      let encodedJson = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) else {
    print("Failed to prepare query parameter")
    return
}

// 3. 定义查询参数
let queryParams: [String: String] = [
    "profileDetail": encodedJson
]

// 4. 发起POST请求，指定参数放在URL查询字符串中
let baseUrl = SharedInstance.sharedInstance.url + "UpdateTenantProfile/UpdateTenantProfiledetails"
_ = ActivityIndicator.show("Loading...".localized(), disableUI: true)

AF.request(baseUrl,
           method: .post,
           parameters: queryParams,
           encoder: URLEncodedFormParameterEncoder(destination: .queryString))
    .validate()
    .responseJSON { response in
        DispatchQueue.main.async {
            ActivityIndicator.hide()
        }
        
        switch response.result {
        case .success(let value):
            print("Success! Response: \(value)")
            // 这里添加你的业务逻辑处理
        case .failure(let error):
            print("Request failed: \(error.localizedDescription)")
        }
    }

关键注意点 #

• 参数位置：后端用@QueryParam接收，所以参数必须在URL的查询字符串中，而不是POST请求的Body里——这是你之前代码的核心错误。
• URL编码：JSON字符串必须经过URL编码，否则其中的引号、斜杠等特殊字符会导致URL无效，后端无法正确解析参数。
• Content-Type：保持和后端@Consumes配置一致，设置为application/json; charset=utf-8即可。

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