Go中多复杂Map键转结构体遇Hiera格式问题，求解决方案

问题背景 #

当YAML中存在多个由结构体组成的复杂Map键时，使用标准yaml库反序列化会报mapping key "" already defined错误——因为默认情况下，未实现yaml.Keyer接口的结构体被当作空字符串键处理，导致键重复。且无法通过YAML别名方案解决（依赖Hiera Server返回固定格式）。

可行解决方案1：自定义Map类型并实现UnmarshalYAML接口 #

通过自定义Map类型，手动处理YAML中复杂键的解析逻辑，绕过默认的键序列化行为。

代码实现 #

package main

import (
	"fmt"
	"gopkg.in/yaml.v3"
)

type Source struct {
	ID   string `yaml:"id"`
	Name string `yaml:"name"`
}

// 自定义Map类型，键为Source，值为string
type SourceMap map[Source]string

// 为SourceMap实现UnmarshalYAML接口，手动解析复杂键
func (sm *SourceMap) UnmarshalYAML(node *yaml.Node) error {
	if node.Kind != yaml.MappingNode {
		return fmt.Errorf("expected mapping node, got %v", node.Kind)
	}

	*sm = make(SourceMap)
	// 遍历映射节点的内容，每两个节点为一组（键+值）
	for i := 0; i < len(node.Content); i += 2 {
		keyNode := node.Content[i]
		valNode := node.Content[i+1]

		// 将键节点解析为Source结构体
		var key Source
		if err := keyNode.Decode(&key); err != nil {
			return err
		}

		// 将值节点解析为字符串
		var val string
		if err := valNode.Decode(&val); err != nil {
			return err
		}

		(*sm)[key] = val
	}
	return nil
}

// 顶层结构体
type Unf struct {
	ItemMeta struct {
		Source SourceMap `yaml:"source"`
	} `yaml:"item_meta"`
}

func main() {
	yamlData := `
unf:
    item_meta:
      source:
        ? id: "012"
          name: "Bill"
        : "some value"
        ? id: "066"
          name: "Bob"
        : "another value"
`
	var data Unf
	if err := yaml.Unmarshal([]byte(yamlData), &data); err != nil {
		panic(err)
	}

	for k, v := range data.ItemMeta.Source {
		fmt.Printf("ID: %s, Name: %s, Value: %s\n", k.ID, k.Name, v)
	}
}

逻辑说明 #

直接遍历YAML映射节点的内容，将每个键节点独立解析为Source结构体，值节点解析为对应字符串，完全绕过默认的键序列化逻辑，避免空字符串键导致的重复错误。

可行解决方案2：为Source实现yaml.Keyer接口 #

如果希望保留标准map[Source]string类型，可让Source结构体实现yaml.Keyer接口，返回一个唯一标识的字符串（比如ID与Name的组合）：

func (s Source) Key() (string, error) {
	// 返回唯一键字符串，确保不同Source实例的键不重复
	return fmt.Sprintf("%s:%s", s.ID, s.Name), nil
}

此时yaml库会用Key()方法返回的字符串作为内部存储键，避免重复键错误，但需确保返回的字符串全局唯一，否则会出现值覆盖问题。

内容的提问来源于stack exchange，提问作者Bob