Go 中 XML 反序列化返回空值的常见原因及解决方法-Golang-PHP中文网

Go 中 XML 反序列化返回空值的常见原因及解决方法

go 的 encoding/xml 包要求结构体字段必须导出（首字母大写）才能被正确反序列化；若字段为小写私有字段，即使标签（xml:"..."）声明正确，也会因反射不可见而始终使用零值。

go 的 encoding/xml 包要求结构体字段必须导出（首字母大写）才能被正确反序列化；若字段为小写私有字段，即使标签（xml:"..."）声明正确，也会因反射不可见而始终使用零值。

在 Go 中使用 encoding/xml.Unmarshal 解析 XML 时，一个极易被忽视却高频出现的问题是：反序列化成功但所有字段值均为零值（如字符串为空、数字为 0、布尔为 false）。这并非 XML 格式或标签语法错误所致，而是源于 Go 的反射机制对字段可见性的严格要求。

核心规则如下：
✅ 只有导出字段（即首字母大写的字段）才能被 xml 包通过反射读取和赋值；
❌ 小写开头的私有字段（如 host, unit, delay）在反射层面不可见，Unmarshal 会跳过它们，保留其零值。

以原始代码为例：

type Throttler struct {
    host  string  `xml:"host,attr"` // ❌ 私有字段：无法被 xml 包访问
    unit  string  `xml:"unit,attr"`
    delay float64 `xml:"delay,attr"`
}

尽管结构体标签 xml:"host,attr" 语法完全正确，但由于 host 等字段未导出，Unmarshal 实际上“看不见”它们，因此不会进行任何赋值操作。

使用Go语言搭建家庭相册系统-相关课件

下载

✅ 正确写法：统一使用导出字段

type Throttler struct {
    Host  string  `xml:"host,attr"` // ✅ 首字母大写，可导出
    Unit  string  `xml:"unit,attr"`
    Delay float64 `xml:"delay,attr"`
}

同时，建议为结构体字段添加适当的 JSON 标签（如需后续序列化），并保持命名符合 Go 习惯（如 Host 对应 XML 属性 host）：

package main

import (
    "encoding/xml"
    "fmt"
)

type Config struct {
    XMLName    xml.Name     `xml:"config"`
    Throttlers []*Throttler `xml:"throttle"`
}

type Throttler struct {
    Host  string  `xml:"host,attr" json:"host"`
    Unit  string  `xml:"unit,attr" json:"unit"`
    Delay float64 `xml:"delay,attr" json:"delay"`
}

func main() {
    data := `<config><throttle delay="20" unit="s" host="feeds.feedburner.com"></throttle></config>`

    var config Config
    err := xml.Unmarshal([]byte(data), &config)
    if err != nil {
        fmt.Printf("unmarshal error: %v\n", err)
        return
    }

    if len(config.Throttlers) == 0 {
        fmt.Println("warning: no throttle elements found")
        return
    }

    thr := config.Throttlers[0]
    fmt.Printf("host:%q, unit:%q, delay:%.0f\n", thr.Host, thr.Unit, thr.Delay)
    // 输出：host:"feeds.feedburner.com", unit:"s", delay:20
}