Go 1.25 t.Attr 如何让 go test -json 带上结构化属性：测试元数据与日志验收

如果测试报告里既要保留“订单号、区域、用例版本”这类可检索信息，又不想把它们拼成一长串日志，Go 1.25 的 t.Attr 正好解决这个缺口：它把键值元数据写入测试输出，在 go test -json 中还能被识别为 attr 事件。

t.Attr 适合记录稳定、短小、便于筛选的测试上下文；正文日志仍交给 t.Log，需要连续写入测试输出流时再用 t.Output。

Go 1.25 给测试输出补上的一块信息

很多团队会在测试名里塞入环境和业务维度，例如 TestOrder/region-cn-shanghai/plan-enterprise。这样做能筛选，却会让测试树越来越长；把同样信息写进普通日志也不理想，因为日志解析器只能把它当作一段文本。

Go 1.25 在 testing.T、testing.B 和 testing.F 上增加了 Attr。官方定义它为与测试关联的任意键值属性，并明确说明 -json 输出会把属性作为 attr 动作发出。这里的“任意”不等于适合塞入大对象，实际使用仍应控制粒度。

先让一个测试产生可筛选的属性

下面的示例模拟订单接口的回归测试。region 和 plan 是报告系统真正要筛选的维度；响应体则属于失败诊断信息，不能混在属性里。

func TestOrder(t *testing.T) {
    t.Attr("region", "cn-shanghai")
    t.Attr("plan", "enterprise")

    got, err := queryOrder("order-1024")
    if err != nil {
        t.Fatal(err)
    }
    t.Logf("order_id=%s status=%s", got.ID, got.Status)
}

属性的调用链很短：TestOrder 调用 t.Attr 写入元数据，测试驱动再把它送入 go test -json 的事件流。断言失败时，t.Fatal 仍然负责终止当前测试，t.Logf 负责留下诊断文本。

用 go test -json 验收 attr 事件

在包含这段测试的模块根目录执行：

go test -json -run '^TestOrder$' ./...

普通终端输出会看到类似 === ATTR TestOrder region cn-shanghai 的行；JSON 模式下，读取器应关注事件的 Action 字段是否为 attr，再读取对应的测试名、键和值。不要用字符串搜索整行来替代 JSON 解析，否则测试名或值中出现空格时很容易误判。

一个最小验收逻辑可以写成：

if event.Action == "attr" && event.Test == "TestOrder" && event.Key == "region" {
    // 检查 event.Value 是否为 cn-shanghai
}

如果报告只需要属性而不需要长日志，测试仍应保持失败路径可读：属性回答“这条测试属于哪个维度”，错误和日志回答“为什么失败”。两者不是同一个字段。

t.Attr、t.Log 和 t.Output 怎么分工

t.Attr(key, value) 适合少量、稳定、可筛选的标签，例如区域、套餐和测试数据版本。t.Log 或 t.Logf 适合人读的诊断段落；它们会在测试失败时保留下来，必要时也可通过详细输出查看。Go 1.25 的 t.Output() 则返回一个 io.Writer，适合已有编码器或多次写入场景，但写出来仍是测试输出文本，不会自动变成属性。

一个常见误区是把请求体、SQL 片段或完整响应 JSON 作为属性值。这样会让报告索引膨胀，也会把敏感字段带进结构化数据。更稳妥的边界是：属性只放“能决定筛选范围”的短值，详细内容由失败日志或脱敏附件承载。

升级到 Go 1.25 时检查这三个边界

• 构建环境确实使用 Go 1.25 或更高版本；如果模块仍由旧工具链执行，testing.T 不会凭空拥有 Attr。
• 报告解析器按 JSON 的 attr 动作处理键值，不要只兼容 run、output 和 pass。
• 属性值经过脱敏和长度控制，尤其不要写入令牌、完整请求头或客户原始数据。

相关问题

t.Attr 会替代 t.Log 吗？

不会。前者是结构化元数据，后者是诊断文本。测试报告通常需要两者同时存在。

为什么终端能看到属性，解析 JSON 却找不到？

先确认命令确实带了 -json，再检查解析器是否忽略了 Action=attr 的事件；不要只读取输出文本事件。

属性应该放业务结果吗？

只放用于筛选的短业务维度。订单状态变化和响应内容仍应由断言、错误或日志表达。

小结

Go 1.25 的 t.Attr 把测试上下文从普通字符串中分离出来，并沿着 go test -json 事件流交给报告系统。把属性控制在稳定短值，把日志留给诊断内容，再用真实的 attr 事件做验收，测试报告会更容易筛选，也更不容易被无关文本拖垮。