如何用Go的reflect递归遍历结构体并设置嵌套字段？

你当前的代码在处理嵌套结构体字段时，会因为未初始化的结构体指针导致reflect.Value.NumField()调用在零值上崩溃，同时还有重复判断逻辑、重复分割key的冗余问题。以下是修复方案：

错误核心原因 #

当处理sub_item字段时，Payload里的SubItem是指针类型，初始值为nil。此时structValue.Field(i).Interface()返回nil，reflect.Indirect处理后得到零值reflect.Value，后续循环调用NumField()自然触发panic。

修复后的完整代码 #

package main

import (
	"fmt"
	"reflect"
	"strings"
)

type Payload struct {
	Type    string   `json:"type"`
	SubItem *SubItem `json:"sub_item"`
}

type SubItem struct {
	Foo string `json:"foo"`
}

func main() {
	var payload Payload
	setValue(&payload, "type", "test1")
	setValue(&payload, "sub_item.foo", "test2")
	fmt.Printf("最终结果: %+v\n", payload)
	fmt.Printf("嵌套字段值: %s\n", payload.SubItem.Foo)
}

func setValue(structPtr interface{}, key string, value string) {
	// 初始检查：必须传入结构体指针
	structVal := reflect.ValueOf(structPtr)
	if structVal.Kind() != reflect.Ptr || structVal.Elem().Kind() != reflect.Struct {
		panic("必须传入结构体指针")
	}
	currentVal := structVal.Elem()

	// 提前分割key，避免重复计算
	keys := strings.Split(key, ".")
	for idx, subKey := range keys {
		isLast := idx == len(keys)-1
		var fieldVal reflect.Value
		found := false

		// 遍历当前结构体的所有字段，匹配json tag
		for i := 0; i < currentVal.NumField(); i++ {
			fieldType := currentVal.Type().Field(i)
			jsonTag := strings.Split(fieldType.Tag.Get("json"), ",")[0]
			if jsonTag != subKey {
				continue
			}

			fieldVal = currentVal.Field(i)
			found = true
			break
		}

		if !found {
			panic(fmt.Errorf("未找到字段: %s", subKey))
		}

		if isLast {
			// 最后一层，设置值
			if fieldVal.CanSet() && fieldVal.Kind() == reflect.String {
				fieldVal.SetString(value)
			} else {
				panic(fmt.Errorf("字段%s不可设置或类型不是string", subKey))
			}
			return
		}

		// 处理嵌套层：如果是指针且为nil，先初始化
		if fieldVal.Kind() == reflect.Ptr && fieldVal.IsNil() {
			// 创建指针指向的结构体实例
			newStruct := reflect.New(fieldVal.Type().Elem())
			fieldVal.Set(newStruct)
			currentVal = newStruct.Elem()
		} else {
			// 处理非指针或已初始化的指针，取实际结构体值
			currentVal = reflect.Indirect(fieldVal)
		}

		// 确保当前是结构体类型，否则无法继续遍历
		if currentVal.Kind() != reflect.Struct {
			panic(fmt.Errorf("字段%s不是结构体或结构体指针", subKey))
		}
	}
}

关键修复点 #

• 提前分割key：避免循环中重复调用strings.Split，提升效率。
• 初始化指针字段：当遇到未初始化的结构体指针时，自动创建新实例并赋值，确保后续能正常遍历其字段。
• 简化逻辑判断：去掉重复的isLast判断，明确分层处理逻辑。
• 增加类型检查：提前校验输入是否为结构体指针，避免非法输入；设置值时检查字段是否可设置、类型是否匹配。

运行结果 #

执行后会输出：

最终结果: {Type:test1 SubItem:0x140000a6020}
嵌套字段值: test2

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