本文详解如何使用 jquery ajax（配合 formdata）向 go 服务端上传文件，并在 gin/net/http 中正确解析 multipart/form-data，解决“no multipart boundary param in content-type”等常见错误。
本文详解如何使用 jquery ajax（配合 formdata）向 go 服务端上传文件，并在 gin/net/http 中正确解析 multipart/form-data，解决“no multipart boundary param in content-type”等常见错误。
在前端通过 AJAX 上传文件时，不能直接将 ArrayBuffer 或 Blob 作为普通表单字段发送——这会导致后端无法识别为 multipart 文件。你原始代码中 fd.append("file", fr.result) 将 ArrayBuffer 作为纯数据附加，破坏了 multipart 的边界结构；同时手动设置 contentType: "multipart/form-data" 却未提供 boundary，正是报错 no multipart boundary param in Content-Type 的根本原因。
✅ 正确做法是：直接将 File 对象（而非其读取结果）传入 FormData，并让浏览器自动构造合法的 multipart 请求：
<script>
$(document).ready(function() {
$('#preview').click(function() {
const fileInput = document.getElementById("widget-file");
const file = fileInput.files[0];
if (!file) return;
const fd = new FormData();
fd.append("file", file); // ← 关键：传 File 实例，非 fr.result！
fd.append("name", "test");
$.ajax({
url: "/admin/snact/info",
type: "POST",
data: fd,
processData: false, // ← 必须 false：禁止 jQuery 序列化 FormData
contentType: false, // ← 必须 false：让浏览器自动设置含 boundary 的 Content-Type
success: function(data) {
console.log("Upload success:", data);
},
error: function(xhr) {
console.error("Upload failed:", xhr.responseText);
}
});
});
});
</script>在 Go 后端（以标准 net/http 或 Gin 框架为例），需注意两点：
- 必须提前调用 ParseMultipartForm（或 Gin 中的 c.Request.ParseMultipartForm()），否则 FormFile 会返回 nil 或 panic；
- *FormFile 返回 `multipart.FileHeader，需用Open()获取io.ReadCloser` 进行读取**。
示例（Gin）：
func handleFileUpload(c *gin.Context) {
// Step 1: 解析 multipart 表单（指定最大内存缓存，单位字节）
err := c.Request.ParseMultipartForm(32 << 20) // 32MB
if err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": "invalid multipart form"})
return
}
// Step 2: 获取文件头
fileHeader, err := c.FormFile("file")
if err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": "file not found or invalid"})
return
}
// Step 3: 打开文件流（实际读取二进制内容）
file, err := fileHeader.Open()
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to open file"})
return
}
defer file.Close()
// 示例：读取全部内容（生产环境建议流式处理大文件）
content, _ := io.ReadAll(file)
log.Printf("Received file '%s', size: %d bytes", fileHeader.Filename, len(content))
// Step 4: 返回响应
c.JSON(http.StatusOK, gin.H{
"filename": fileHeader.Filename,
"size": fileHeader.Size,
"mime": fileHeader.Header.Get("Content-Type"),
})
}⚠️ 注意事项：
- processData: false 和 contentType: false 缺一不可，否则 jQuery 会强行序列化 FormData 或覆盖 Content-Type；
- ParseMultipartForm 的参数是内存缓存上限，超出部分将写入临时磁盘文件，务必根据业务设定合理值；
- 若使用标准 http.Handler，需调用 r.ParseMultipartForm(...)，且确保 r.Body 未被提前读取；
- 文件名、MIME 类型等元信息可通过 fileHeader.Filename 和 fileHeader.Header.Get("Content-Type") 获取；
- 安全提示：始终校验 fileHeader.Size 和 fileHeader.Header.Get("Content-Type")，防范恶意上传。
总结：前端上传的核心是「交由浏览器构造 multipart」，后端的关键是「显式解析 + 安全读取」。跳过 FileReader 直接传 File 对象，配合 Go 端规范解析流程，即可稳定处理任意二进制文件上传。
