Go slog.Record Clone 怎样避免属性数据被后续修改

把 slog.Record 直接赋值给另一个变量，看起来像是已经复制了一份日志记录；但当记录包含超过内联容量的属性时，副本仍可能共享属性切片的底层数组。一个副本随后调用 AddAttrs，就可能让另一个副本看到不应出现的属性，或者在并发场景中产生数据竞争。

官方地址：https://pkg.go.dev/log/slog#Record.Clone

下面只讨论 Record 和属性存储的复制边界，不讨论日志级别过滤与 Handler 配置。示例中的输出是静态说明，图片也是结构说明图，不是本机运行截图。

直接复制 Record，为什么仍可能共享属性存储

Record 包含时间、级别、消息、程序计数器，以及一组 Attr。当前实现会把少量属性放在记录自身的内联数组里，更多属性放到 back []Attr。因此，执行 copy := original 时，前面的固定字段会按值复制，而 back 只复制指针、长度和容量。

package main

import "log/slog"

func unsafeCopy(r slog.Record) slog.Record {
	// 值复制只复制 Record 外壳；属性切片的底层存储可能仍然共享。
	copyOfRecord := r
	// 追加属性可能复用共享容量，异步传递前不要把这种副本当作独立记录。
	copyOfRecord.AddAttrs(slog.String("stage", "worker"))
	return copyOfRecord
}

这个问题不是“字段全部变了”，而是更隐蔽的容量复用：当副本追加属性时，如果底层数组还有空间，追加会写入共享数组。即使调用方暂时没有观察到错误，也不应该把这种复制方式作为跨 goroutine 的所有权转移。

Record.Clone 做了什么，为什么能隔离后续 AddAttrs

官方实现的关键动作是对 back 使用 slices.Clip，让副本不再保留可供追加复用的共享容量。源码注释也明确说明：Clone 返回没有共享状态的副本，原记录和克隆记录可以互不干扰地修改。

package main

import (
	"log/slog"
	"time"
)

func cloneForEnrichment(r slog.Record) slog.Record {
	// Clone 先隔离 Record 的属性存储，再由当前层追加自己的字段。
	cloned := r.Clone()
	cloned.AddAttrs(
		slog.String("layer", "audit"),
		slog.Time("handled_at", time.Unix(0, 0)),
	)
	return cloned
}

这里的安全点是“先 Clone，再 AddAttrs”。如果先把原记录直接赋值给变量，再依赖一次普通赋值来隔离切片，依然没有建立独立的属性存储。Clone 解决的是 Record 内部属性容器的共享，不是所有嵌套值的递归复制。

异步 Handler 或队列传递时，复制点应该放在哪里

Handler 的 Handle 调用通常处在日志调用链中。如果实现会把 Record 保存到队列、交给后台 goroutine，或者在当前调用返回后继续追加字段，就应在“交出所有权”的边界调用 Clone。这样消费者拿到的是自己的记录，生产者可以结束当前调用而不再承担共享属性存储的责任。

package main

import (
	"context"
	"log/slog"
)

type queue struct {
	items chan slog.Record
}

func (q *queue) enqueue(ctx context.Context, r slog.Record) error {
	// 进入异步队列前建立独立副本，避免消费者依赖调用方的生命周期。
	owned := r.Clone()
	select {
	case q.items 

复制点应靠近队列入站处，而不是等后台消费者已经开始修改后才补救。若队列只保存不可变的序列化字节，也可以把序列化结果作为所有权边界；但在保存 slog.Record 本身时，Clone 是更直接的选择。

Clone 仍然不是深复制：Attr 里的引用值要单独处理

Record.Clone 只保证 Record 自己的属性存储不再共享。slog.Any 可以携带 slice、map、指针或自定义结构体；这些值仍然遵循 Go 对引用和值的原有语义。如果属性中放的是可变 map，Clone 后修改这个 map，另一个记录仍可能看到同一 map 的变化。

package main

import "log/slog"

func attachSnapshot(r slog.Record, labels map[string]string) slog.Record {
	// Clone 只隔离 Attr 容器；业务 map 仍需复制成快照再放入日志。
	snapshot := make(map[string]string, len(labels))
	for key, value := range labels {
		snapshot[key] = value
	}
	cloned := r.Clone()
	cloned.AddAttrs(slog.Any("labels", snapshot))
	return cloned
}

工程上可以把风险分成两层：第一层是 Record 的属性数组是否独立，交给 Clone；第二层是 Attr 携带的业务对象是否可变，交给快照、不可变对象或明确的所有权约定。只修第一层，不能自动得到深复制语义。

什么时候必须 Clone：一张速查表

判断标准不是“代码里有没有等号赋值”，而是“这个 Record 是否会在当前调用边界之外继续被读写”。一旦生命周期跨过 Handler 调用、队列发送或 goroutine 启动边界，就应把 Clone 作为最小的所有权声明。

常见问题

只读遍历 Attr 也需要 Clone 吗？

如果遍历发生在当前 Handler 调用内，且不会把 Attr 或 Record 保存到外部，一般不需要。需要跨调用保存时，再把 Clone 放在交出所有权的位置。

Clone 会复制 Attr 里的 map 和 slice 吗？

不会。Clone 解决的是 Record 属性存储的共享；map、slice、指针和自定义对象是否独立，需要调用方创建快照或使用不可变数据。

普通值复制什么时候仍然够用？

只在副本不追加属性、不跨生命周期传递，并且调用方能保证不会并发读写时才适合。作为 Handler 的通用边界，Clone 更清楚。

为什么不直接手工重新创建一个 Record？

手工重建容易遗漏时间、级别、消息或程序计数器等字段。Clone 由标准库维护复制语义，调用方只需关注 Attr 中的业务引用值。

最终可以记住一句话：slog.Record 的值复制不等于属性存储复制；需要把记录交给后续代码时，先 Clone，需要隔离属性里的 map 或 slice 时，再额外做业务数据快照。