当前位置：首页 > 文章列表 > Golang > Go问答 > Go test -json 输出如何按 Action 还原测试事件

Go test -json 输出如何按 Action 还原测试事件

来源：17golang原创 2026-09-09 12:38:54 0浏览收藏

很多 CI 工具执行 go test -json ./... 后，第一反应是读取每行 JSON，再看到 Action=output 就当成一条结果。这样做很快会遇到两个问题：并行测试的事件会交错，日志也会被拆成多条。正确做法是把它看成一个按顺序到达的事件流：用 Package 和 Test 定位对象，用 Action 更新状态，再把同一对象的 Output 拼起来。

要点速览

Test 有值时通常是具体测试、示例或 benchmark；为空时是包级事件。
output 只表示一段标准输出或标准错误，不代表通过或失败。
以 pass、fail、skip 等终态收口，不能只看最后一行日志。

先把 go test -json 看成 TestEvent 流

Go 官方的 test2json 将测试输出编码为换行分隔的 JSON。每一行对应一个事件，常见字段包括 Time、Action、Package、Test、Elapsed 和 Output。流通常从 start 开始；真正判断结果时，应关注终态 Action，而不是输出文本中的“PASS”字样。

字段或 Action	解析时的含义	容易犯的错
Package	事件所属包；并行包执行时用来隔离流	只用 Test 名称做全局 key
Test	具体测试、示例或 benchmark；为空表示包级事件	把包级 pass 当成某个测试的 pass
run / pause / cont	测试开始、暂停、继续	把 pause 当作失败
output	一段原始输出，可能要多次拼接	每条 output 都生成一条结果
pass / fail / skip / bench	测试或 benchmark 的收口状态	只按输出文本猜状态

用 Package 加 Test 还原并行事件

当测试调用了 t.Parallel()，事件顺序不再是“一个测试完整结束后才开始下一个”。同一条流里可能先后出现不同测试的 run、output 和 pass。因此建议使用 Package + "\x00" + Test 作为测试级复合键，使用空字符串 Test 的另一条记录保存包级信息。

不要为了排序而按测试名重新排列事件。保留读取顺序，日志才能与 Action 对齐；需要展示时，再按复合键输出聚合后的摘要。

Go test -json 按 Package 和 Test 分流的事件流关系图 — 图1：同一条 go test -json 流按 Package 与 Test 分成包级、测试级事件支路。

按 Action 更新状态，不要把 output 当结果

最小解析器可以只保留每个对象的当前状态、耗时和输出缓冲。下面的示例故意不运行测试，也不假设事件一定连续；它展示的是消费边界：

type TestEvent struct {
    Package string  `json:"Package"`
    Test    string  `json:"Test"`
    Action  string  `json:"Action"`
    Elapsed float64 `json:"Elapsed"`
    Output  string  `json:"Output"`
}

type Result struct {
    State   string
    Elapsed float64
    Output  strings.Builder
}

func consume(r io.Reader) (map[string]*Result, error) {
    results := make(map[string]*Result)
    scanner := bufio.NewScanner(r)
    // 测试日志可能很长，扩大单行 JSON 的读取上限。
    scanner.Buffer(make([]byte, 4096), 1024*1024)

    for scanner.Scan() {
        var event TestEvent
        if err := json.Unmarshal(scanner.Bytes(), &event); err != nil {
            return nil, err // 坏行要交给上层决定是否终止流水线
        }
        key := event.Package + "\x00" + event.Test
        item := results[key]
        if item == nil {
            item = &Result{}
            results[key] = item
        }
        if event.Action == "output" {
            item.Output.WriteString(event.Output) // 多条 output 必须按到达顺序拼接
            continue
        }
        switch event.Action {
        case "run", "pause", "cont", "pass", "fail", "skip", "bench":
            item.State = event.Action
            item.Elapsed = event.Elapsed
        }
    }
    return results, scanner.Err()
}

这里的关键点有三个：output 只写入缓冲区；Elapsed 主要在终态事件上有意义；包级事件因为 Test 为空，必须允许单独存在。若只关心最终结果，可以在输出摘要时过滤 start、run、pause 和 cont。