Go 1.27 go test -json OutputType 怎么解析：区分错误、续行与帧

测试平台接入 go test -json ./... 后，最麻烦的往往不是读 JSON，而是判断某一行究竟是测试框架标记、断言错误，还是多行错误的后续内容。Go 1.27 给 Action == "output" 的事件增加了可选字段 OutputType，解析器终于可以少依赖字符串前缀，但仍要兼容空值和未来未知值。

先固定 TestEvent 的输入契约

官方 cmd/test2json 文档说明，输出是一行一个 TestEvent 的 JSON 流。Go 1.27 中，OutputType 可能出现在 Action == "output" 的事件上；它不是所有事件都有的必填字段。

type TestEvent struct {
    Time        time.Time `json:"Time,omitempty"`
    Action      string    `json:"Action"`
    Package     string    `json:"Package,omitempty"`
    Test        string    `json:"Test,omitempty"`
    Elapsed     float64   `json:"Elapsed,omitempty"`
    Output      string    `json:"Output,omitempty"`
    OutputType  string    `json:"OutputType,omitempty"`
    FailedBuild string    `json:"FailedBuild,omitempty"`
}

这个结构体故意给新增字段保留 omitempty。读取 Go 1.26 或其他未提供该字段的事件时，零值就是空字符串，不需要维护两套 JSON 模型。

把 JSON 流按行解码，不要一次读完整文件

go test -json 面向实时状态，官方工具不会做不必要的输入输出缓冲。消费端也应逐行处理：一行坏数据只记录并继续，避免一个损坏事件让整份测试报告消失。

func ReadEvents(r io.Reader, handle func(TestEvent)) error {
    scanner := bufio.NewScanner(r)
    scanner.Buffer(make([]byte, 64*1024), 2*1024*1024)

    for scanner.Scan() {
        var event TestEvent
        if err := json.Unmarshal(scanner.Bytes(), &event); err != nil {
            log.Printf("忽略无法解析的测试事件: %v", err)
            continue
        }
        handle(event)
    }
    return scanner.Err()
}

这里提高了 Scanner 的最大 token，原因是失败日志可能包含较长的一行。它不是越大越好：生产环境还应给输入总量、单行长度和保存时间设置上限。

用 OutputType 做稳定分类

当前官方定义的非空值有三种：frame、error、error-continue。空字符串是普通输出。解析器的门禁顺序应该先看 Action，再看 OutputType，否则可能把其他事件误判成日志。

type LineKind string

const (
    KindRegular LineKind = "regular"
    KindFrame   LineKind = "frame"
    KindError   LineKind = "error"
    KindMore    LineKind = "error-continue"
)

func Classify(event TestEvent) LineKind {
    if event.Action != "output" {
        return KindRegular
    }
    switch event.OutputType {
    case "frame":
        return KindFrame
    case "error":
        return KindError
    case "error-continue":
        return KindMore
    default:
        return KindRegular
    }
}

default 返回普通输出比返回“无效事件”更稳妥。这样既兼容旧版本的空字段，也不会在 Go 后续增加新分类时吞掉用户日志。

多行错误要按 Package 与 Test 分组

error-continue 不是独立错误，它用于延续前一个 error。与此同时，多个包并行测试时事件会交错，因此不能只维护一个全局“当前错误”。最小分组键可以写成：

type TestKey struct {
    Package string
    Test    string
}

type ErrorGroup struct {
    Lines []string
}

func Append(groups map[TestKey]*ErrorGroup, event TestEvent) {
    if event.Action != "output" {
        return
    }
    key := TestKey{Package: event.Package, Test: event.Test}

    switch event.OutputType {
    case "error":
        groups[key] = &ErrorGroup{Lines: []string{event.Output}}
    case "error-continue":
        if group := groups[key]; group != nil {
            group.Lines = append(group.Lines, event.Output)
        }
    }
}

如果续行先于首行到达，示例选择不创建伪错误。更严格的平台可以把它记入“孤立续行”计数，同时仍把原始 Output 写入完整日志，便于回查数据源。

报告层分别展示框架行、错误和普通输出

分类完成后，不要把所有行重新拼成一个文本框。比较实用的布局是：frame 作为测试状态标记，error 与续行组成一个错误块，普通输出进入可折叠日志。最终的 pass、fail、skip 仍由 Action 决定，不能从 OutputType 推断。

• 收到 run：创建测试记录，但不创建错误块。
• 收到 output/frame：更新框架状态，不计为用户日志错误。
• 收到 output/error：为对应 Package/Test 开启错误块。
• 收到 output/error-continue：追加到已有错误块。
• 收到 pass、fail 或 skip：关闭该测试的聚合状态。

容易踩的三个坑

只匹配 “--- FAIL” 前缀

字符串前缀会混淆测试框架输出和用户自己打印的相似文本。Go 1.27 之后优先使用 OutputType，前缀匹配只适合作为旧数据的有限回退。

把空 OutputType 当成解析失败

官方把该字段定义为可选，空值就是常规输出。拒绝空值会让旧版本事件和普通日志大量丢失。

只按 Test 字段聚合

不同包可以有同名测试，事件也可能交错。至少使用 Package + Test；需要区分重跑时，再加入本地生成的运行批次 ID。

常见问题

Go 1.26 的 JSON 能用同一个结构体解析吗？

可以。缺少 OutputType 时字符串零值为空，按普通输出处理即可。

OutputType 能决定测试是否失败吗？

不能。测试最终状态应读取 Action 的 pass、fail、skip；OutputType 只解释 output 行。

为什么不用 go tool test2json 直接处理多个包？

官方建议一般场景直接使用 go test -json。go tool test2json 主要用于单独运行一个测试二进制时转换输出。

遇到未来新增的 OutputType 怎么办？

保留原始 Output 并按普通日志展示，同时记录未知分类指标。这样不会因工具链升级丢失信息。

结语

Go 1.27 的 OutputType 让测试报告不必再从文本前缀猜语义。可靠实现的关键不是写一个更复杂的 switch，而是守住三条边界：只解释 output 事件、按 Package/Test 隔离多行错误、对空值和未知值保留原始输出。