反射赋值

我第一次在配置映射代码里遇到“反射赋值不生效”，问题并不在 Set 的参数，而在于拿到的 reflect.Value 只是一个不可修改的副本。判断这类问题最直接的办法是先看 CanSet()：它只有在值可寻址、且不是从未导出字段得到时才会返回 true。

官方资料：https://pkg.go.dev/reflect

对普通变量，记住一条稳定写法：reflect.ValueOf(&x).Elem()。ValueOf(x) 观察的是传入值的副本，ValueOf(&x) 才带着原变量的地址，继续调用 Elem() 才得到可以修改 x 的目标值。

CanSet 为 false 到底说明了什么

我现在排查反射赋值时，会把原因拆成两个问题，而不是直接给 Set 加一层恢复。第一，目标值是否可寻址；第二，它是否因为未导出字段而被标记为只读。官方实现对 CanSet 的判断正是“有地址标记且没有只读标记”。所以 CanAddr() 为 false 时，不能靠换一个 setter 解决；而未导出字段即使来自可寻址结构体，也不能绕过可见性限制。

常见的误区是这样写：

package main

import "reflect"

func main() {
	var count int = 3
	v := reflect.ValueOf(count)
	// ValueOf(count) 接收的是值副本，因此这里不能直接改回 count。
	if v.CanSet() {
		v.SetInt(8)
	}
}

这个判断可以避免 panic，但它不会让 count 变成 8。排查时要问的是“这个 Value 是否指向原始存储”，而不是“SetInt 能不能接受一个整数”。

普通变量要从指针的 Elem 开始

需要修改原变量时，把地址交给反射，再解引用到目标值：

package main

import "reflect"

func setInt(target *int, next int64) bool {
	// 指针 Value 本身代表地址，Elem 才是要写入的 int。
	v := reflect.ValueOf(target).Elem()
	// 先确认目标仍可写，再调用与 Kind 对应的 setter。
	if !v.IsValid() || !v.CanSet() || v.Kind() != reflect.Int {
		return false
	}
	v.SetInt(next)
	return true
}

这里的接口边界很重要：ValueOf(&count) 的 CanSet 仍然是 false，因为它表示指针值本身；Elem() 返回的才是变量存储对应的 Value。传入 nil 指针时，Elem() 会得到无效值，因此先用 IsValid() 保护后续调用。

结构体字段还要检查导出状态

从结构体指针得到可寻址结构体后，导出字段通常可以赋值，未导出字段则不可以。字段名首字母大写只是 Go 语法层面的可见性表现，反射也会把这个限制保留下来。

type Profile struct {
	Name  string
	secret string
}

func setName(p *Profile, name string) bool {
	// 从结构体地址 Elem，才能让字段有机会回写原对象。
	s := reflect.ValueOf(p).Elem()
	f := s.FieldByName("Name")
	// FieldByName 找不到字段时返回无效 Value；未导出字段也不能 Set。
	if !f.IsValid() || !f.CanSet() || f.Kind() != reflect.String {
		return false
	}
	f.SetString(name)
	return true
}

如果业务确实需要修改 secret，更稳妥的做法是给结构体增加导出的修改方法或调整数据模型，而不是使用 unsafe 绕过反射的安全边界。反射代码越通用，越应该把“字段存在、类型匹配、允许写入”都当作调用方契约。

把 Set 前的判断变成接口契约

我的经验是，通用赋值函数不要只返回一个空错误的 panic 恢复结果。至少要区分无效值、不可写值和类型不匹配，这样调用方才知道应该修正参数、传入指针，还是更换字段名。

这套判断也解释了为什么“把 SetInt 换成 Set”通常不是修复方案：setter 只负责写入动作，真正决定权限的是目标 Value 的来源和状态。

几个容易再次踩中的边界

• 指针本身不是目标：reflect.ValueOf(&x) 表示指针，修改 x 要对它调用 Elem。
• 空接口只是容器：把结构体放进 any 再反射，仍然可能只是副本；是否可写取决于传入的是值还是指针。
• 未导出字段不能硬改：CanInterface、CanSet 和字段可见性是不同问题，不要把读取限制当成写入许可。
• 赋值类型必须匹配：CanSet 为真只表示“允许写”，不表示任意 reflect.Value 都能写进去。

常见问题

为什么 ValueOf(x).CanSet 一直是 false？

因为传入的是值，反射拿到的是副本。要修改原变量，使用 reflect.ValueOf(&x).Elem()。

CanAddr 为 true 就一定能赋值吗？

不一定。未导出字段可能仍然不可写；最终是否调用 Set，应以 CanSet 为准。

能不能用 recover 代替 CanSet 判断？

不建议。recover 只能隐藏错误，不能告诉调用方是副本、字段可见性还是类型不匹配导致失败。

反射赋值的稳定路径可以压缩成一句话：先拿到原始存储的地址，再用 Elem 得到目标值，随后依次判断 IsValid、CanSet、Kind/Type，最后才调用 setter。这样处理，CanSet=false 就不再是模糊报错，而是一个明确的接口边界。