Go unsafe.Pointer 和 uintptr 之间为什么不能长期转换

在 Go 里，unsafe.Pointer 转成 uintptr 并不等于“把指针换了一种写法保存起来”。unsafe.Pointer 仍属于运行时可以识别的指针语义，而 uintptr 只是一个整数：它不会让对象保持存活，也不会随着对象地址变化而自动更新。因此，把转换结果放进结构体、全局变量、缓存或异步任务里，通常就是生命周期错误。

可以把 uintptr 当作短暂的地址数值使用，但不要把它当作长期引用。需要跨语句、跨函数或跨 goroutine 保存时，保留真实指针、索引或显式句柄。

先分清：地址数值和对象引用不是一回事

下面的转换在语法上成立，但它的结果只适合立即打印、记录或参与受限的地址计算：

package main

import (
    "fmt"
    "unsafe"
)

func main() {
    value := uint64(42)
    // 这里只把地址临时变成整数用于观察，不把它当作对象引用保存。
    address := uintptr(unsafe.Pointer(&value))
    fmt.Printf("address=0x%x value=%d\n", address, value)
}

GC 只会追踪它认识的指针位置。变量 address 里即使碰巧还存着原地址，也不能阻止 value 被回收；如果运行时调整对象位置，这个整数也不会同步改变。短时间内“看起来没问题”，只是没有刚好撞上回收或移动相关的时机。

只有受限的临时转换，才适合做地址计算

Go 文档允许一种典型模式：从一个已分配对象出发，转成 uintptr 加上字段或元素偏移，再立刻转回 unsafe.Pointer。结果必须仍然指向原对象内部，不能越过分配范围：

type header struct {
    flags uint32
    size  uint64
}

func sizeAddress(h *header) *uint64 {
    // 偏移只服务于同一次地址计算，结果仍落在 h 这块分配对象内。
    p := unsafe.Pointer(uintptr(unsafe.Pointer(h)) + unsafe.Offsetof(h.size))
    return (*uint64)(p)
}

这里的关键不是“允许把 uintptr 存进变量”，而是转换和运算紧挨着完成。不要拆成 u := uintptr(p) 后再在另一条语句里恢复指针；也不要把它推进到对象末尾之外。若只是做字节或字段偏移，优先考虑较新的 unsafe.Add，或者用正常的字段访问和切片操作表达意图。

长期保存时，改存指针、索引或句柄

这类写法的问题不在于能不能编译，而在于把一个没有引用语义的数字交给了未来的代码：

type cache struct {
    // 错误思路：地址整数不能让对象保持存活，也无法表达所有权。
    address uintptr
}

type safeCache struct {
    // 更直接：由真实指针表达对象仍被这条路径使用。
    value *uint64
}

func keepValue(v *uint64) safeCache {
    return safeCache{value: v}
}

如果缓存只需要定位数组元素，保存下标并在使用时检查范围通常更清楚；如果要跨 C 或操作系统接口传递地址，按该接口的官方约定使用，并让转换出现在调用表达式中。对象在调用期间必须保持可达时，可在最后一次实际使用后调用 runtime.KeepAlive，但它不能把一个已经变成 uintptr 的长期地址重新变成安全引用。

用工具找线索，再按生命周期复查

go vet 的 unsafeptr 分析器可以提示部分从 uintptr 恢复指针的可疑用法；开发或测试阶段也可以打开 checkptr，让越界、错误对象归属等问题更早暴露：

# 先让静态分析寻找明显的 uintptr/指针转换风险。
go vet ./...

# 测试阶段增强指针检查；它是辅助线索，不是安全证明。
go test -gcflags=all=-d=checkptr=2 ./...

复查时沿着四个问题走：这个地址对应的对象由谁持有？转换结果会不会跨函数或异步保存？转回的指针是否仍在原分配对象内？如果外部调用需要地址，转换是否直接出现在调用参数里？只要其中一项说不清，就不要把“当前测试没崩”当作正确性证明。

两个容易混淆的问题

把 uintptr 放进全局变量，调用 runtime.KeepAlive 能补救吗？

不能。KeepAlive 需要接收仍然代表对象的 Go 值；它可以延长一次调用期间的可达性，但不会让一个长期保存的整数重新获得指针语义。应回到数据结构设计，保存指针、索引或句柄。

unsafe.Pointer 转 uintptr 再转回来，为什么有时一直能用？

因为内存尚未被回收、地址暂时未变化，或测试没有覆盖到 GC 压力和并发交错。这是偶然条件，不是 Go 对任意往返转换的保证。只有文档列出的受限模式才应保留。

参考资料

• Go 官方 unsafe.Pointer 文档与实现注释
• Go 语言规范：unsafe 包
• unsafeptr 静态分析器说明