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。中间换行必须是 rn（不是 n），否则服务端拒绝解析。
func createMultipartBody(xmlData: Data, fileName: String, boundary: String) -> Data { var body = Data() // 起始 boundary body.append("--(boundary)rn".data(using: .utf8)!) // 文件头 body.append("Content-Disposition: form-data; name="file"; filename="(fileName)"rn".data(using: .utf8)!) body.append("Content-Type: application/xmlrnrn".data(using: .utf8)!) // XML 内容（原始字节，不编码） body.append(xmlData) // 结束 boundary（注意末尾两个破折号） body.append("rn--(boundary)--rn".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 = "test - 务必检查
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 字节必须原样塞入，中间不加任何编码或换行处理——这些地方错一点，服务端就收不到文件。