XML文件上传必须使用multipart/form-data格式，需手动构造含boundary、Content-Disposition和Content-Type头的请求体，用URLSession.uploadTask(with:from:)发送原始XML字节，不可直接POST字符串或base64编码。
XML文件必须用 multipart/form-data 发送，不能直接 POST 原始数据
iOS 中上传 XML 文件（比如配置文件、订单数据）本质是 HTTP 文件上传，服务端通常只认 multipart/form-data 格式。直接把 XML 字符串塞进 URLRequest.httpBody 会导致服务端解析失败——它收不到字段名、文件名、Content-Type 等必要元信息。
正确做法是手动构造 multipart body，用唯一 boundary 分隔各部分，并为 XML 内容添加标准头：Content-Disposition: form-data; name="file"; filename="config.xml" 和 Content-Type: application/xml。
- 别用
URLSession.uploadTask(with:from:)：它只支持整个文件路径或 Data，不支持自定义字段和多部分结构 - 必须用
URLSession.uploadTask(with:from:)的 Data 版本，自己拼接 body - boundary 字符串不能含空格或下划线，推荐用 UUID 字符串（如
"Boundary-\(UUID().uuidString)"）
如何构造合法的 multipart body（Swift 5.9+）
关键在按顺序写入：起始 boundary → 文件头 → XML 原始字节 → 结束 boundary。中间换行必须是 \r\n（不是 \n），否则服务端拒绝解析。
func createMultipartBody(xmlData: Data, fileName: String, boundary: String) -> Data {
var body = Data()
// 起始 boundary
body.append("--\(boundary)\r\n".data(using: .utf8)!)
// 文件头
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"\(fileName)\"\r\n".data(using: .utf8)!)
body.append("Content-Type: application/xml\r\n\r\n".data(using: .utf8)!)
// XML 内容（原始字节，不编码）
body.append(xmlData)
// 结束 boundary（注意末尾两个破折号）
body.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)
return body
}
-
xmlData必须是原始 XML 字节（例如从xmlString.data(using: .utf8)!得到），不要 base64 编码 - 字段名
"file"必须和服务端约定一致；有些接口叫"upload"或"xml_file"，看文档 - 如果还需传其他参数（如 token），在 body 开头或结尾再追加一段
Content-Disposition: form-data; name="token"
设置 request 并发起上传（含错误处理）
除了 body，Content-Type 头必须带 boundary，且请求方法固定为 POST。上传失败常见于超时、证书校验、或服务端返回 400/500 但没走 completionHandler 的 error 分支。
let url = URL(string: "https://api.example.com/upload")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
request.timeoutInterval = 60
let xmlData = "<?xml version=\"1.0\"?><config><mode>test</mode></config>".data(using: .utf8)!
let body = createMultipartBody(xmlData: xmlData, fileName: "config.xml", boundary: boundary)
let task = URLSession.shared.uploadTask(with: request, from: body) { data, response, error in
if let error = error {
print("Upload failed: \(error.localizedDescription)")
return
}
guard let httpResponse = response as? HTTPURLResponse else { return }
if (200...299).contains(httpResponse.statusCode) {
print("Upload succeeded")
} else {
print("HTTP error: \(httpResponse.statusCode)")
}
}
task.resume()
- 务必检查
httpResponse.statusCode，很多服务端上传失败返回 400 却不抛 error - iOS 15+ 默认启用 TLS 1.3，若服务端只支持 TLS 1.2，需在
URLSessionConfiguration中显式降级 - 大 XML 文件（>10MB）建议用后台 session，避免挂起时中断
调试上传失败的三个必查点
90% 的 XML 上传失败不是代码问题，而是协议细节错位：
- 抓包看实际发出的 body 是否含完整 boundary、
filename和application/xml—— 用Charles或mitmproxy拦截 localhost 请求 - 确认服务端接收字段名（
name="file"）是否匹配，大小写敏感，且没被 Nginx 或 CDN 过滤掉 - 检查 XML 是否含非法字符（如未转义的
&、控制字符），用String(data: xmlData, encoding: .utf8)能正常打印才算合规
boundary 一旦定死就别改，XML 字节必须原样塞入，中间不加任何编码或换行处理——这些地方错一点，服务端就收不到文件。
