Gin 默认不支持 YAML 请求体是因为未注册 YAML 绑定器，这是为避免隐式依赖和反序列化安全风险的设计选择；需手动引入 gopkg.in/yaml.v3 并注册绑定器或使用 ShouldBindWith 显式调用。
为什么 Gin 默认不支持 YAML 请求体
Gin 的 c.ShouldBindJSON() 和 c.ShouldBind() 默认只识别 Content-Type: application/json，即使你发的是 YAML 内容、header 设为 application/yaml，Gin 也不会自动调用 YAML 解析器——它根本没注册 YAML 绑定器。这不是 bug，是设计选择：避免隐式依赖和安全风险（比如 YAML 的复杂对象构造可能触发反序列化漏洞）。
手动注册 YAML 绑定器并使用 ShouldBind
你需要显式注册一个 YAML 绑定器，并确保项目已引入 gopkg.in/yaml.v3（推荐 v3，v2 已停止维护）。注册后，c.ShouldBind() 才能根据 Content-Type 自动路由到 YAML 解析逻辑。
实操步骤：
- 安装依赖：
go get gopkg.in/yaml.v3 - 在 main 或 router 初始化处注册绑定器：
import "gopkg.in/yaml.v3"<br>gin.RegisterValidator(&yamlBinding{})（注意：Gin v1.9+ 原生支持ShouldBindWith，但 YAML 绑定器仍需手动实现） - 更稳妥的做法是直接用
c.ShouldBindWith(&config, yamlBinding{})，避免依赖 Content-Type 自动识别
用 ShouldBindWith + 自定义 yamlBinding 处理请求
最可控的方式是绕过自动 Content-Type 路由，显式指定绑定器。你需要写一个轻量级的 yamlBinding 结构体，实现 Bind 方法：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
type yamlBinding struct{}<br><br>func (yamlBinding) Bind(r *http.Request, obj interface{}) error {<br> if r == nil || r.Body == nil {<br> return fmt.Errorf("invalid request body")<br> }<br> data, err := io.ReadAll(r.Body)<br> if err != nil {<br> return err<br> }<br> return yaml.Unmarshal(data, obj)<br>}
然后在 handler 中调用：c.ShouldBindWith(&cfg, yamlBinding{})。这样无论 header 是什么，都走 YAML 解析路径。
注意点：
- YAML 解析默认允许别名、锚点等特性，如需禁用（提升安全性），用
yaml.UnmarshalStrict - 如果前端发的是
text/yaml或没有设置 Content-Type，ShouldBind()会 fallback 到 JSON，导致解析失败；ShouldBindWith可规避这个问题 - 字段 tag 必须是
yaml:"field_name"，不是json:"field_name"，否则字段映射为空
接收 raw YAML 字符串再解析（适合调试或动态配置）
有时你不想直接绑定结构体，而是先拿到原始 YAML 文本做校验、预处理或存档。这时用 c.GetRawData() 最直接：
data, err := c.GetRawData()<br>if err != nil {<br> c.AbortWithStatusJSON(400, gin.H{"error": "read body failed"})<br> return<br>}<br>var cfg map[string]interface{}<br>if err := yaml.Unmarshal(data, &cfg); err != nil {<br> c.AbortWithStatusJSON(400, gin.H{"error": "invalid yaml"})<br> return<br>}
这种方式灵活，但失去结构体类型检查和字段验证能力。适合灰度发布配置、模板注入等场景。
容易漏掉的细节：Gin 的 c.Request.Body 是单次读取流，一旦被 GetRawData() 或 ShouldBind 消费，后续再读就是空；如需多次使用，得用 c.Request.Body = io.NopCloser(bytes.NewBuffer(data)) 回填。
