go的xml.marshal默认不生成xml声明头，需手动拼接或用xml.encoder写入；cdata需独占tag且值为纯字符串；命名空间须通过xml.name设置；time.time反序列化应先转string再解析以兼容多格式。
xml.Marshal 生成的 XML 没有声明头（）
Go 的 xml.Marshal 默认不加 XML 声明，而很多旧系统接口严格校验这个头，直接拒收。这不是 bug，是设计选择——因为 xml.Marshal 只负责序列化结构体，不处理传输协议层的包装。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 手动拼接声明头：
xml.Header + string(xmlBytes)，注意换行符必须是\n（Windows 下别用\r\n，部分 Java 服务会解析失败） - 用
xml.Encoder配合bufio.Writer更稳妥，先写声明再 encode：buf := &bytes.Buffer{} buf.WriteString(`<?xml version="1.0" encoding="UTF-8"?>\n`) enc := xml.NewEncoder(buf) enc.Encode(v) - 别依赖
encoding/xml自动补头——它不会做
struct tag 中 name 和 cdata 同时出现导致序列化为空
旧系统常要求某个字段以 CDATA 包裹，比如 <content>hello</content>
xml:"content,cdata" 又写 xml:"content"，或字段类型是 string 却漏掉 cdata，Go 就会忽略该字段或输出空标签。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
cdata必须独占 tag，不能和 name 混用：Content string `xml:"content,cdata"`✅；Content string `xml:"content,omitempty,cdata"`❌（omitempty与cdata冲突，会被忽略） - CDATA 字段值本身不要带
，encoder 会自动包，你传纯字符串就行 - 如果字段要支持空值且用 CDATA，用指针类型：
*string，配合xml:",omitempty"不生效时，改用逻辑判断是否写入
XML 命名空间（xmlns）没生效，请求被对方报“Invalid namespace”
很多遗留系统要求根节点带 xmlns="http://xxx"，但只在 struct tag 写 xml:"root xmlns=\"http://xxx\"" 是无效的——encoding/xml 不解析属性字符串里的等号赋值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用嵌套 struct 表示命名空间：
type Envelope struct { XMLName xml.Name `xml:"http://xxx root"` Body Body `xml:"body"` } - 如果需动态 namespace（比如测试/生产不同），把
XMLName改成变量：XMLName xml.Name `xml:"-"`，encode 前手动赋值：v.XMLName = xml.Name{Space: "http://prod", Local: "root"} - 别在 tag 里硬编码
xmlns:前缀（如xml:"soap:Envelope"），除非你同时定义了xmlns:soap属性字段并正确设置值
对接老系统时 time.Time 字段反序列化失败，报 “parsing time ... as ...: cannot parse ...”
旧系统返回的日期格式五花八门：2023-01-01、2023-01-01T00:00:00、甚至 01/01/2023。Go 的 time.Time 默认只认 RFC3339 和一些固定格式，一碰到不匹配就 panic 或零值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 别让 struct 字段直接是
time.Time，改用string接收，后续按需解析 - 如必须用
time.Time，实现UnmarshalXML方法，内部用time.Parse多个 layout 尝试（推荐顺序：time.RFC3339→"2006-01-02"→"01/02/2006"） - 注意时区：老系统可能没带 tz 信息，默认按
time.Local解析，但对方实际是 UTC——建议统一转成time.UTC存储，避免后续计算错
