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 分支。
特色介绍: 1、ASP+XML+XSLT开发,代码、界面、样式全分离,可快速开发 2、支持语言包,支持多模板,ASP文件中无任何HTML or 中文 3、无限级分类,无限级菜单,自由排序 4、自定义版头(用于不规则页面) 5、自动查找无用的上传文件与空目录,并有回收站,可删除、还原、永久删除 6、增强的Cache管理,可单独管理单个Cache 7、以内存和XML做为Cache,兼顾性能与消耗 8、
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 = "test ".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 字节必须原样塞入,中间不加任何编码或换行处理——这些地方错一点,服务端就收不到文件。









