Go slog.Attr.Equal 判断结构化字段是否一致的实现方式

在日志测试或自定义 Handler 中，我更愿意直接比较 slog.Attr，而不是先把日志格式化成字符串再比。slog.Attr.Equal 判断的是两个属性的键和值是否相等；它不会因为文本 Handler 的空格、时间格式或字段顺序变化而误报。先记住这条边界：比较结构化数据用 Attr.Equal，展示日志才用字符串。

先区分 Attr、Value 与字符串化结果

slog.Attr 是结构化日志中的一个键值对，Value 才是承载字符串、整数、时间、分组或任意 Go 值的部分。把 Attr 调用 String() 后再比较，会把结构数据压扁成展示文本，无法稳定表达类型和分组层级。

用 Attr.Equal 比较普通结构化字段

下面的测试刻意覆盖同键同值、同键不同值和不同键三种情况。代码中的比较对象保持为 Attr，便于以后替换 Handler 或调整文本格式而不改变断言。

package main

import (
    "fmt"
    "log/slog"
)

func main() {
    want := slog.Int("status", 200)
    got := slog.Int("status", 200)

    // Attr.Equal 同时比较字段名和字段值，适合结构化断言。
    fmt.Println(want.Equal(got))
    fmt.Println(want.Equal(slog.Int("status", 500)))
    fmt.Println(want.Equal(slog.Int("code", 200)))
}

输出依次是 true、false、false。这里不需要比较 status=200 这类格式化文本，也不需要把整数先转成字符串。

处理分组属性和动态 LogValuer

分组属性的键和值共同构成比较对象；同样的叶子字段放在不同分组下，不能简单视为相等。遇到实现了 slog.LogValuer 的动态值，先决定测试的是“延迟对象”还是“解析后的日志值”。如果业务关心最终输出，可以显式调用 Resolve，再用 Value.Equal 比较。

package main

import (
    "fmt"
    "log/slog"
)

type account struct{ ID int }

// LogValue 只暴露稳定字段，避免日志直接展开整个业务对象。
func (a account) LogValue() slog.Value {
    return slog.GroupValue(slog.Int("id", a.ID))
}

func main() {
    left := slog.Any("account", account{ID: 7})
    right := slog.Any("account", account{ID: 7})

    // Resolve 得到 LogValuer 的最终 Value，再比较其语义值。
    fmt.Println(left.Value.Resolve().Equal(right.Value.Resolve()))
}

用表格固化比较边界

在自定义 Handler 里，官方约定是空键和值均为零值的 Attr 可以忽略，常见判断方式仍然是与 slog.Attr{} 比较。若目标是字段去重，还要额外定义“同名字段取前者还是后者”的策略；Attr.Equal 只负责单个属性的相等判断，不替你决定集合规则。

延伸问答

slog.Attr.Equal 会比较字段顺序吗？

它比较的是两个 Attr，不是 Attr 切片；字段顺序属于上层集合或 Handler 的问题。

为什么不直接比较 Attr.String？

字符串是展示结果，可能受格式化 Handler、类型呈现和分组路径影响，不能代表稳定的数据契约。

Value.Equal 能替代 Attr.Equal 吗？

不能完全替代。Value.Equal 不包含 Key；需要比较完整属性时，优先使用 Attr.Equal。