如何使用Golang反射设置嵌套结构体的指定路径字段值

问题原因 #

嵌套字段赋值失败通常是两个核心原因：

• 没有正确处理中间字段的可寻址性，若中间字段为指针类型时未做解引用/空指针初始化
• 未校验字段的可设置权限（未导出字段反射无法修改）

实现代码 #

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

func setVal(data interface{}, fieldPath []string, val string) error {
    // 校验入参必须为非空指针，才能修改原对象
    v := reflect.ValueOf(data)
    if v.Kind() != reflect.Ptr || v.IsNil() {
        return errors.New("data must be a non-nil pointer")
    }
    current := v.Elem()

    // 迭代遍历所有层级字段
    for idx, fieldName := range fieldPath {
        // 非最后一层字段必须为结构体类型，才能继续取下级字段
        if current.Kind() != reflect.Struct {
            return fmt.Errorf("path '%s' is not a struct type", strings.Join(fieldPath[:idx+1], "."))
        }

        // 取当前字段
        field := current.FieldByName(fieldName)
        if !field.IsValid() {
            return fmt.Errorf("field '%s' does not exist", strings.Join(fieldPath[:idx+1], "."))
        }
        if !field.CanSet() {
            return fmt.Errorf("field '%s' cannot be modified (please make sure it is exported)", strings.Join(fieldPath[:idx+1], "."))
        }

        // 到达最后一层字段，执行赋值
        if idx == len(fieldPath)-1 {
            // 示例仅处理string类型，可根据需求扩展其他类型转换逻辑
            if field.Kind() != reflect.String {
                return fmt.Errorf("field '%s' is not string type", strings.Join(fieldPath, "."))
            }
            field.SetString(val)
            return nil
        }

        // 处理中间字段的指针类型：解引用，空指针自动初始化
        for field.Kind() == reflect.Ptr {
            if field.IsNil() {
                field.Set(reflect.New(field.Type().Elem()))
            }
            field = field.Elem()
        }

        // 更新current为当前字段值，进入下一层级遍历
        current = field
    }
    return nil
}

测试验证 #

type Player struct {
    Name string
    IDCard Card
}

type Card struct {
    ID string
}

func main() {
    p := Player{
        Name: "Tsuru",
        IDCard: Card{ID: "id"},
    }

    fieldPath_Name := []string{"Name"}
    fieldPath_ID := []string{"IDCard", "ID"}

    // 赋值顶层字段
    _ = setVal(&p, fieldPath_Name, "Miku")
    fmt.Println(p.Name) // 输出：Miku

    // 赋值嵌套字段
    _ = setVal(&p, fieldPath_ID, "newID")
    fmt.Println(p.IDCard.ID) // 输出：newID
}

扩展说明 #

如果需要支持string以外的字段类型（比如int、bool等），只需要在最后一层赋值的位置，根据目标字段的Kind()做对应的类型转换即可。

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