Golang怎么实现内容协商_Golang如何根据Accept头返回JSON或XML格式的响应【方法】-Golang-PHP中文网

需手动解析Accept头：用mime.ParseMediaType拆解各条目，按q权重排序取最高优先级type/subtype，忽略参数但保留vnd前缀，空或无效时fallback为application/json。

golang怎么实现内容协商_golang如何根据accept头返回json或xml格式的响应【方法】

怎么用 `net/http` 读取 `Accept` 头并做格式判断

Go 标准库不自动解析 Accept 头，得自己手动提取、解析、匹配。别指望 http.ServeContent 或路由框架（比如 Gin）默认帮你干这事——它们顶多提供快捷方法，底层逻辑还得你写。

常见错误是直接用 strings.Contains(r.Header.Get("Accept"), "json")，这会误判 application/vnd.api+json 或漏掉 application/json; charset=utf-8 这类带参数的值。

用 mime.ParseMediaType() 拆解每个 Accept 条目，拿到主类型、子类型和参数
按 RFC 7231 规则，需按权重（q=）排序，取最高优先级的有效类型
只比对 type/subtype，忽略参数（如 charset），但保留 vnd 这类关键前缀
记得 fallback：当 Accept 为空或无法解析时，返回默认格式（通常是 JSON）

怎么封装一个可复用的协商函数（`negotiateContentType`）

硬编码 if-else 判断太脆弱，容易漏掉 application/xml、text/xml 甚至 application/atom+xml 这些合法 XML 类型。应该把支持的格式声明为常量 + 映射表，再让协商逻辑集中处理。

示例逻辑：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

func negotiateContentType(h http.Header) string {
	accept := h.Get("Accept")
	if accept == "" {
		return "application/json"
	}
	for _, s := range strings.Split(accept, ",") {
		mediaType, _, _ := mime.ParseMediaType(strings.TrimSpace(s))
		switch mediaType {
		case "application/json", "text/json":
			return "application/json"
		case "application/xml", "text/xml", "application/atom+xml":
			return "application/xml"
		}
	}
	return "application/json" // 默认
}

不要在 switch 里写 */* 或 */json —— Go 的 mime 不支持 glob 匹配，写了也白写
如果项目用 encoding/xml，注意它不支持 nil 字段输出空标签，而 JSON 会输出 null；这点会影响前端是否认为字段“存在”
返回的 Content-Type 值必须和实际序列化方式严格一致，否则浏览器可能拒绝解析或触发下载

为什么 `xml.Marshal` 输出的 XML 缺少声明头（）

encoding/xml 默认不加 XML 声明，这是设计使然，不是 bug。但某些老系统或测试工具会依赖这个声明来识别内容类型，导致协商后返回 XML 却被当成纯文本。

手动拼接声明头：先写，再写 xml.Marshal 结果
注意：不能直接往 http.ResponseWriter 写两次，要确保一次写入（避免 header 已发送错误）
更稳妥的做法是用 bytes.Buffer 先组装完整 body，再统一写入响应
如果用了 xml.Header 自定义声明，务必确认编码与 Content-Type 中的 charset 一致（例如 charset=UTF-8）

Gin / Echo 等框架里怎么避免重复实现协商逻辑

框架通常提供 Context.Negotiate 或 Context.Render，但它们只负责“选模板”，不自动读 Accept。真正起作用的是你注册的 NegotiationMap 或中间件。

Gin：调用 c.Negotiate(200, gin.Negotiate{Offered: []string{"application/json", "application/xml"}, JSON: data, XML: data})，框架内部才去查 Accept
Echo：要用 c.Negotiate 并提前注册 echo.HTTPError 和 echo.HTTPRenderer，否则会 panic
别信文档里“自动协商”的说法——没显式传 Offered 列表，框架根本不知道你支持哪些格式
自定义中间件比依赖框架协商更可控，尤其当你需要兼容非标准 Accept 值（如 text/x-json）时

内容协商真正的复杂点不在“怎么选格式”，而在“选完之后怎么保证序列化行为一致”：JSON 的 omitempty、XML 的 xml:",omitempty" 行为不同；时间字段默认格式不同；nil slice 在 JSON 是 null，在 XML 可能直接消失。这些细节不统一，前端就容易出隐性 bug。