根本原因是前端手动设置了 Content-Type: multipart/form-data 但未携带 boundary 参数，导致浏览器或 axios 放弃自动生成合法 boundary，使请求体不符合 multipart 协议语法；正确做法是不设置 Content-Type，交由客户端自动注入含 boundary 的完整头。
为什么 Axios 发 multipart 请求总报 “no multipart boundary found”
根本原因是前端手动设置了 Content-Type: multipart/form-data，但没带 boundary 参数，而浏览器或 axios 本该自动生成并注入这个 boundary —— 一旦你显式写了 header，它就放弃自动填充，导致请求体语法不合法。
典型错误写法：
axios.post('/upload', formData, {
headers: { 'Content-Type': 'multipart/form-data' } // ❌ 错！删掉这行
})
- 浏览器表单提交时，
enctype="multipart/form-data"会自动计算 boundary 并写入 header 和 body，无需干预 - 用
FormData构造请求时，必须让 axios 完全控制 header；只要你不设Content-Type，它就会从FormData实例里读出真实 boundary 并填进去 - 如果用了拦截器全局设置了
Content-Type（比如设成application/json或application/x-www-form-urlencoded），上传请求也会被覆盖，直接失效
Gin 后端怎么避免 c.FormFile 返回 nil
不是 Gin 不支持，而是你提前“偷看了”请求体 —— c.PostForm、c.Request.Body 读取、甚至 c.ShouldBind 都会消耗 body 流，后续 c.FormFile 就拿不到原始 multipart 数据了。
- 确保调用
c.FormFile("file")前，没碰过c.Request.Body或任何触发 body 解析的 API - 不要在同一个 handler 里混用
c.PostForm("xxx")和c.FormFile("file")；如需同时读字段和文件，统一用c.MultipartForm() - Gin 默认最大内存缓存是 32MB，超限会写临时文件；若磁盘不可写（比如容器里没挂卷、权限为只读），
c.FormFile会静默失败，返回nil, err，错误信息类似http: no such file
如何验证请求真的带 boundary
别猜，直接看抓包或日志。关键看两点：请求头是否含 Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryxxx，以及请求体开头是否真有那一行 ------WebKitFormBoundaryxxx。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 用浏览器 DevTools 的 Network → Payload 查看原始请求体，确认第一行是
--boundary-string开头 - 在 Gin 中加一行日志：
log.Println("Content-Type:", c.Request.Header.Get("Content-Type"))，检查输出是否含boundary= - 如果看到
Content-Type: multipart/form-data（没等号、没 boundary），说明前端 header 写死了，立刻删掉
跨域场景下 Axios + Gin 文件上传的隐藏陷阱
跨域时，浏览器会先发 OPTIONS 预检请求；如果后端没正确响应预检，后续 POST 根本发不出去 —— 此时你看到的“boundary 缺失”，其实是连请求体都没发过来，压根没走到 multipart 解析那步。
- Gin 要配
cors.New(cors.Config{AllowOrigins: []string{"http://localhost:8080"}, AllowMethods: []string{"POST", "OPTIONS"}, AllowHeaders: []string{"*"}})，特别注意AllowHeaders必须包含Content-Type - 如果前端用了
withCredentials: true，后端AllowOrigins不能写*，必须指定具体域名 - Nginx 反向代理时，要透传
Content-Type头，且确保client_max_body_size足够大（默认 1MB，上传大文件会直接 413）
boundary 缺失往往不是单一环节的问题，而是前端 header 控制、网络链路透传、后端解析三者中任一环断开所致。最稳的做法：先用浏览器原生表单验证通路，再逐步替换成 axios 和 FormData。
