Go 1.26 runtime/secret 怎么保管短命密钥：生成、使用与清零边界

服务端处理一次性解密材料时，真正难受的往往不是“密钥有没有放进环境变量”，而是解密函数返回以后，寄存器、栈和临时堆对象还要在内存里停留多久。Go 1.26 的实验性 runtime/secret 提供了一个很窄但有用的边界：把处理短命秘密的调用树放进 secret.Do，让临时存储更快进入擦除路径。

runtime/secret 适合缩短密码学临时数据的存活窗口，不是密钥管理系统，也不能保证程序里所有副本自动消失。

Go 1.26 到底新增了哪一层保护

官方发布说明把 runtime/secret 定义为实验性包，目标是清理处理秘密信息时使用的临时数据，典型场景是密码学运算。它不是把明文变成“不可读取”，而是把清理责任放到一个明确的调用边界上。

启用实验包要在构建时设置 GOEXPERIMENT=runtimesecret。源码中的构建约束也明确写着：没有这个实验开关时，包不会作为稳定 API 出现；因此不要把它当作跨版本兼容的基础依赖。

把解密临时态收进 secret.Do

假设业务已经有一个只在本次请求中使用的 decryptPayload 函数。关键不是伪造一个“安全密钥库”，而是让 plaintext 的使用范围尽量贴近实际操作：

package main

import (
    "fmt"
    "runtime/secret"
)

func decryptPayload(ciphertext []byte) []byte {
    plaintext := make([]byte, len(ciphertext))
    copy(plaintext, ciphertext)
    return plaintext
}

func handle(ciphertext []byte) {
    secret.Do(func() {
        plaintext := decryptPayload(ciphertext)
        fmt.Println(len(plaintext))
    })
}

这段代码里，secret.Do 是边界，decryptPayload 是调用链上的实际工作，plaintext 是需要缩短存活时间的临时数据。它们不是三个并列的安全措施：只有把秘密处理逻辑放进这个调用树，包才有机会清理这段执行期间使用的寄存器和栈。

闭包里只放本次计算需要的动作

闭包结束后，secret.Do 会处理它调用树使用过的寄存器与栈。若把日志拼接、缓存写入、异步投递等无关动作也塞进闭包，秘密的生命周期边界会变得模糊，排查时很难判断究竟是哪一段代码持有了数据。

还有一个容易误解的地方：源码注释说明，调用树中的堆分配要等垃圾回收器确认对象不再可达后才会擦除。因此 secret.Do 不是“函数返回瞬间把所有堆内存归零”的承诺。

启用前先验收实验边界

本地实验至少要把开关、平台和依赖版本写进验收记录。可以先用下面的命令构建：

GOEXPERIMENT=runtimesecret go test ./...

如果构建机器不是 Linux amd64 或 Linux arm64，不要因为代码能通过静态检查就直接推断运行时行为相同。官方 release notes 当前只列出这两个架构支持；跨平台项目应将该能力做成可替换实现，而不是把实验包散落在业务层。

哪些问题不能交给 runtime/secret

它不能替代 KMS、硬件安全模块、密钥轮换、访问控制或传输层保护。密钥如果先被复制到全局变量、请求日志、错误对象、消息队列或另一个长期缓存里，调用边界之外的副本不属于 secret.Do 的清理范围。

同样不要把“临时数据更快擦除”写成“内存取证绝对无法恢复”。安全结论要结合编译器、运行时、操作系统、崩溃转储和日志策略验证，实验性 API 的行为也可能随 Go 版本调整。

从实验到上线的最小检查

1. 锁定 Go 版本与目标平台，确认构建确实带有 GOEXPERIMENT=runtimesecret。
2. 检查 secret.Do 的闭包，只保留解密、派生或签名所需的短链路。
3. 搜索 plaintext、密钥参数和错误路径，确认没有写入日志、全局状态或长期缓存。
4. 用 go test ./... 做回归，并单独记录实验包失效时的降级方案。

相关问题

runtime/secret 是稳定的 Go 1 API 吗？

不是。官方源码标明它是实验性包，不受 Go 1 兼容性承诺约束，必须显式设置 GOEXPERIMENT=runtimesecret。

用了 secret.Do 就不用管理密钥了吗？

不用。它只处理调用树中的临时存储擦除问题，密钥来源、轮换、权限、日志和备份仍要由完整的密钥管理方案负责。

这个能力的价值在于把“秘密临时态在哪里结束”变成可审查的代码边界。先限定调用树和副本，再做平台回归，结论才不会超出 runtime/secret 实际提供的范围。