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 分支。