multipart/form-data 是专为传输二进制数据设计的 HTTP 请求体编码格式，区别于默认的 application/x-www-form-urlencoded，后者会 URL 编码破坏原始字节流；使用 FormData.append() 自动处理 boundary，不可手动设置 Content-Type。
multipart/form-data 是什么，和普通表单提交有什么区别
它是一种 HTTP 请求体编码格式，专为传输二进制数据（比如图片、XML、PDF）设计，不是“协议”也不是“API”，而是 Content-Type 的一种取值。浏览器原生
提交时设 enctype="multipart/form-data"，就会触发这种编码；而默认的 application/x-www-form-urlencoded 会把所有内容 URL 编码成键值对，根本没法传原始字节流——XML 文件里如果有 、>、中文或换行，直接被破坏。
用 fetch 上传 XML 文件时怎么构造 multipart/form-data
不能手动拼接 boundary 和分隔符，必须让浏览器或 FormData 自动处理。核心是：把文件对象（File 或 Blob） append 进 FormData，然后交给 fetch 发送——此时请求头 Content-Type 会被自动设置为 multipart/form-data; boundary=...，你不用也不该手动写。
- 确保
的accept属性设为"application/xml"或".xml"，避免用户选错类型 -
FormData.append()的第一个参数是字段名（后端约定的 key），第二个是File对象，第三个可选（文件名，一般留空让浏览器自动取） - 不要给
fetch手动加headers: { 'Content-Type': '...' }，否则会覆盖FormData自动生成的带 boundary 的头，导致 400 或解析失败
const form = document.querySelector('form');
form.addEventListener('submit', async (e) => {
e.preventDefault();
const fileInput = form.querySelector('input[type="file"]');
const file = fileInput.files[0];
if (!file) return;
const formData = new FormData();
formData.append('xml_file', file); // 后端 expect field name 'xml_file'
const res = await fetch('/upload', {
method: 'POST',
body: formData // ✅ 不要加 headers
});
});
Node.js 后端（Express）如何解析 multipart/form-data 中的 XML
Express 默认不解析 multipart，必须用中间件。推荐 multer，它把文件写入内存或磁盘，并把元信息挂到 req.file 或 req.files 上。注意：XML 是文本，但 multer 默认当二进制处理，所以你要显式指定 storage 或用 file.buffer 转字符串。
- 如果 XML 较小（memoryStorage()，直接读
req.file.buffer.toString() - 若需校验 XML 格式，可在解析前用
libxmljs或fast-xml-parser尝试 parse，捕获语法错误 - 别用
req.body.xml_file——那是urlencoded解析的结果，multipart 下 XML 内容在req.file里
const multer = require('multer');
const upload = multer({ storage: multer.memoryStorage() });
app.post('/upload', upload.single('xml_file'), (req, res) => {
if (!req.file) return res.status(400).send('No file uploaded');
try {
const xmlStr = req.file.buffer.toString('utf8');
// 可选：验证是否为合法 XML
// const doc = libxmljs.parseXmlString(xmlStr);
console.log('Received XML:', xmlStr.substring(0, 200));
res.send('OK');
} catch (err) {
res.status(400).send('Invalid XML');
}
});
curl 命令行上传 XML 文件的写法
调试或脚本调用时常用 curl。关键点：用 -F 参数，它会自动设置 Content-Type: multipart/form-data 并生成 boundary；文件路径前加 @ 符号；字段名必须和后端约定一致。
-
-F "xml_file=@data.xml"表示以字段名xml_file上传当前目录下的data.xml - 如果 XML 文件路径含空格或特殊字符，用引号包裹整个
-F参数 - 加
-v查看实际发出的请求头和 body 分界，确认 boundary 是否出现
curl -v -X POST http://localhost:3000/upload / -F "xml_file=@./config.xml"
XML 文件本身没有特殊结构要求，但如果你的后端做了 MIME 类型校验（比如检查 req.file.mimetype === 'application/xml'），那前端传的 File 对象的 type 属性或 curl 的 -F 推断就很重要——浏览器通常能根据扩展名设对，但手动构造 Blob 时得显式传 { type: 'application/xml' }。