fiber 默认不解析 xml 请求体，因其基于 fasthttp 且仅注册 application/json 和 application/x-www-form-urlencoded 的自动解析器；遇 application/xml 或 text/xml 时，c.bodyparser() 会静默失败或报错，需手动用 xml.unmarshal 解析原始字节。
为什么 Fiber 默认不解析 XML 请求体
Fiber 是基于 Fasthttp 的 Go Web 框架，而 Fasthttp 为性能考虑，默认只注册了 application/json 和 application/x-www-form-urlencoded 两种内容类型的自动解析器。当客户端发送 Content-Type: application/xml 或 text/xml 时，c.Body() 虽能读到原始字节，但 c.BodyParser() 会直接返回 UnmarshalTypeError 或静默失败——因为它根本没绑定 XML 解码器。
手动注册 xml.Unmarshal 解析器（推荐）
最轻量、可控的方式是显式调用 Go 标准库的 xml.Unmarshal，绕过 BodyParser()。适用于已知结构体且不频繁切换格式的场景：
<pre class="brush:php;toolbar:false;">type User struct {
ID int `xml:"id"`
Name string `xml:"name"`
}
app.Post("/user", func(c *fiber.Ctx) error {
var u User
if err := xml.Unmarshal(c.Body(), &u); err != nil {
return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{"error": err.Error()})
}
return c.JSON(u)
})
注意点：
c.Body() 返回的是 <code>[]byte，可直接传给xml.Unmarshal；不需要先转strings.NewReader或bytes.NewReader- 结构体字段必须导出（首字母大写），且
xmltag 不可省略，否则解析结果为空 - 若请求体含 XML 声明（如
<?xml version="1.0"?>），xml.Unmarshal可安全处理，无需提前截断
用中间件统一支持 BodyParser 解析 XML
如果多个路由都需要 XML 解析，且希望保持 c.BodyParser(&u) 的调用习惯，可以注册自定义解析器：
<pre class="brush:php;toolbar:false;">app.Use(func(c *fiber.Ctx) error {
ct := c.Get("Content-Type")
if strings.HasPrefix(ct, "application/xml") || strings.HasPrefix(ct, "text/xml") {
if err := xml.Unmarshal(c.Body(), c.Locals("parser-target")); err != nil {
return c.Status(fiber.StatusBadRequest).SendString("XML parse error: " + err.Error())
}
return c.Next()
}
return c.Next()
})
// 然后在 handler 中：
app.Post("/order", func(c *fiber.Ctx) error {
var o Order
c.Locals("parser-target", &o)
if err := c.BodyParser(&o); err != nil {
return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{"error": "invalid XML"})
}
return c.JSON(o)
})
这个方案的问题在于：BodyParser
Locals 透传指针——实际开发中容易漏设或类型错配，调试成本高。更稳妥的做法仍是第一种：显式解码。
常见错误：空结构体、字段未匹配、编码不一致
典型现象是解析后字段全为零值，比如 ID=0, Name=""。原因通常有：
- XML 字段名大小写/下划线与结构体 tag 不一致，例如 XML 是
<user_id>123</user_id>，但结构体写成了UserID int `xml:"userid"`（少个下划线） - XML 使用了命名空间（如
<user xmlns:ns="http://example.com"></user>），而结构体未声明xmlns字段或未用xml:",any"捕获 - 客户端发的是 UTF-8 BOM 头（
EF BB BF），Go 的xml包无法跳过，需提前 strip：bytes.TrimPrefix(c.Body(), []byte("\xef\xbb\xbf")) - 结构体字段是值类型而非指针，而 XML 中该字段缺失，导致无法区分“零值”和“未提供”——建议对可选字段用
*string、*int并配合xml:",omitempty"
encoding/xml 上。真正需要花时间的不是框架配置，而是 XML 结构与 Go 结构体之间的映射细节——尤其是命名空间、空元素、属性混合等边界情况，往往要靠打印 c.Body() 原始内容+逐字段比对才能定位。
