Go HTTP服务器设multipart/form-data，客户端却收到text/plain

核心问题分析 #

你遇到的情况主要是两个关键问题导致的：

1. multipart/form-data 头部缺少必填的 boundary 参数
   HTTP 规范要求 multipart/form-data 类型必须指定 boundary（分隔符），否则服务器会自动将 Content-Type 降级为 text/plain; charset=utf-8——这就是你客户端收到错误头部的直接原因。
2. 头部设置时机错误或被覆盖
   如果在写入响应体之后才设置 Content-Type，Go 的 HTTP 栈会在第一次写入时自动发送默认头部，后续的头部修改不会生效；另外也可能存在中间件或其他代码覆盖了你的头部设置。

正确实现步骤 #

1. 严格设置包含 boundary 的 Content-Type

必须在任何响应体写入操作之前，设置完整的 Content-Type 头部，示例代码：

boundary := "custom-cert-boundary-789"
// 先设置头部，包含boundary参数
w.Header().Set("Content-Type", fmt.Sprintf("multipart/form-data; boundary=%s", boundary))

2. 按规范构建 multipart 响应体

响应体必须严格遵循 multipart 格式：

• 每个文件部分以 --{boundary} 开头
• 紧跟文件的 Content-Disposition、Content-Type 等头部
• 空行分隔头部与文件内容
• 最后以 --{boundary}-- 结束所有部分
• 所有行分隔符必须用 \r\n（不能只用 \n，否则解析会失败）

完整的服务器端示例：

package main

import (
	"fmt"
	"net/http"
	"strings"
)

func certHandler(w http.ResponseWriter, r *http.Request) {
	boundary := "cert-boundary-12345"
	// 提前设置正确的Content-Type
	w.Header().Set("Content-Type", fmt.Sprintf("multipart/form-data; boundary=%s", boundary))

	// 构建multipart各部分
	var parts []string
	// 第一个证书文件
	parts = append(parts, fmt.Sprintf("--%s", boundary))
	parts = append(parts, "Content-Disposition: form-data; name=\"root_cert\"; filename=\"root.pem\"")
	parts = append(parts, "Content-Type: application/x-x509-ca-cert")
	parts = append(parts, "")
	parts = append(parts, "-----BEGIN CERTIFICATE-----\nMIIC...省略证书内容...\n-----END CERTIFICATE-----")

	// 第二个证书文件
	parts = append(parts, fmt.Sprintf("--%s", boundary))
	parts = append(parts, "Content-Disposition: form-data; name=\"client_cert\"; filename=\"client.pem\"")
	parts = append(parts, "Content-Type: application/x-x509-ca-cert")
	parts = append(parts, "")
	parts = append(parts, "-----BEGIN CERTIFICATE-----\nMIIB...省略证书内容...\n-----END CERTIFICATE-----")

	// 结束标记
	parts = append(parts, fmt.Sprintf("--%s--", boundary))

	// 写入响应体
	w.Write([]byte(strings.Join(parts, "\r\n")))
}

func main() {
	http.HandleFunc("/download-certs", certHandler)
	http.ListenAndServe(":8080", nil)
}

3. 客户端正确解析

客户端需要从响应头部提取 boundary，再用 multipart.NewReader 解析：

// 客户端示例代码
resp, err := http.Get("http://localhost:8080/download-certs")
if err != nil {
	panic(err)
}
defer resp.Body.Close()

// 从Content-Type中提取boundary
var boundary string
for _, part := range strings.Split(resp.Header.Get("Content-Type"), ";") {
	part = strings.TrimSpace(part)
	if strings.HasPrefix(part, "boundary=") {
		boundary = strings.TrimPrefix(part, "boundary=")
		break
	}
}

reader := multipart.NewReader(resp.Body, boundary)
for {
	part, err := reader.NextPart()
	if err != nil {
		break // 处理EOF或错误
	}
	defer part.Close()
	// 读取证书内容
	fmt.Printf("读取文件: %s\n", part.FileName())
}

额外排查点 #

• 检查是否有中间件（如CORS、日志中间件）修改了响应头部
• 确认代码中没有在 w.Write() 之后才设置 Content-Type 的逻辑

内容的提问来源于stack exchange，提问作者Jerome