Go借助反射实现复杂对象自定义Unmarshal方法的问题求助

报错根因 #

你当前的报错来自UnmarshalJSON实现的逻辑错误：你把JSON原始内容反序列化成map[string]interface{}后，对于*osInfo这类自定义嵌套结构体类型，标准库解析出来的对应值是map[string]interface{}类型，reflect.Value.Convert方法只能处理类型兼容的转换，无法自动把哈希表映射成结构体实例，所以会触发panic。
同时你自己接管所有字段的反射解析逻辑完全没有必要，标准JSON库本身就能处理99%的常规字段，你只需要单独处理ChannelsInfo这个需要数组/Map互转的特殊字段即可。

快速修复方案 #

利用Go类型别名避免JSON方法递归调用，定义临时结构体覆盖特殊字段的类型，其余字段直接交给标准库解析，完全不需要大switch或者全量反射处理：

func (instance *MetricOne) MarshalJSON() ([]byte, error) {
    // 定义别名避免递归调用MarshalJSON
    type MetricAlias MetricOne
    // 把ChannelsInfo从Map转成数组
    channels := make([]*statusChannel, 0, len(instance.ChannelsInfo))
    for _, ch := range instance.ChannelsInfo {
        channels = append(channels, ch)
    }
    // 临时结构体只覆盖特殊字段，其余字段复用原有逻辑
    tmp := &struct {
        ChannelsInfo []*statusChannel `json:"channels_info"`
        *MetricAlias
    }{
        ChannelsInfo: channels,
        MetricAlias:  (*MetricAlias)(instance),
    }
    return json.Marshal(tmp)
}

func (instance *MetricOne) UnmarshalJSON(data []byte) error {
    type MetricAlias MetricOne
    // 临时结构体把ChannelsInfo定义为数组类型，匹配JSON结构
    tmp := &struct {
        ChannelsInfo []*statusChannel `json:"channels_info"`
        *MetricAlias
    }{
        MetricAlias: (*MetricAlias)(instance),
    }
    // 所有常规字段直接由标准库解析
    if err := json.Unmarshal(data, tmp); err != nil {
        log.GetInstance().Error(fmt.Sprintf("Error: %s", err))
        return err
    }
    // 单独处理ChannelsInfo数组转Map
    instance.ChannelsInfo = make(map[string]*statusChannel, len(tmp.ChannelsInfo))
    for _, ch := range tmp.ChannelsInfo {
        instance.ChannelsInfo[ch.ChannelId] = ch
    }
    // 原有迁移逻辑保留
    instance.Migrate(nil)
    return nil
}

这个方案可以直接解决你当前的报错，且不需要修改原有结构体定义，代码量比你原来的实现少70%。

通用化实现方案 #

如果你后续有多个字段需要这种「JSON序列化为数组、代码里用Map存」的需求，可以用泛型封装一个通用的自定义类型，一次实现到处复用：

// ArrayMap 通用类型：代码层面用Map存储，JSON序列化/反序列化自动转数组
// K 为Map键的类型，V为Map值的类型
type ArrayMap[K comparable, V any] struct {
    Data   map[K]V
    GetKey func(V) K // 从值中提取Map键的逻辑，初始化时传入
}

// MarshalJSON 实现json.Marshaler接口，自动把Map转成数组序列化
func (am ArrayMap[K, V]) MarshalJSON() ([]byte, error) {
    arr := make([]V, 0, len(am.Data))
    for _, val := range am.Data {
        arr = append(arr, val)
    }
    return json.Marshal(arr)
}

// UnmarshalJSON 实现json.Unmarshaler接口，自动把数组转成Map存储
func (am *ArrayMap[K, V]) UnmarshalJSON(data []byte) error {
    var arr []V
    if err := json.Unmarshal(data, &arr); err != nil {
        return err
    }
    am.Data = make(map[K]V, len(arr))
    for _, val := range arr {
        key := am.GetKey(val)
        am.Data[key] = val
    }
    return nil
}

使用时只需要修改原有结构体的字段类型即可：

type MetricOne struct {
    // 其余字段保持不变
    // 把原来的map[string]*statusChannel替换为自定义ArrayMap类型
    ChannelsInfo ArrayMap[string, *statusChannel] `json:"channels_info"`
}

// 初始化结构体时传入键提取逻辑
metric := &MetricOne{
    ChannelsInfo: ArrayMap[string, *statusChannel]{
        GetKey: func(ch *statusChannel) string {
            return ch.ChannelId
        },
    },
}

// 使用时直接访问ChannelsInfo.Data就能拿到Map
// 不需要再自定义MetricOne的MarshalJSON/UnmarshalJSON方法，标准库自动处理

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