当前位置：首页 > 文章列表 > Golang > Go教程 > Go 1.27 go test -json OutputType 怎么解析：区分错误、续行与帧

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

来源：17golang原创 2026-08-31 20:22:40 0浏览收藏

所属专题：Go 1.27 工具链诊断与 CI 兼容工程专题 - 从 go doc、go test -json 到 trace 与版本矩阵验收

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

实践要点

只在 Action 为 output 时解释 OutputType。
frame 是测试框架行，error 是错误首行，error-continue 是多行错误续行。
字段为空代表普通输出；遇到未知值也应保留 Output，不要直接丢弃。
事件可能按包和测试交错，聚合状态至少要按 Package 与 Test 隔离。

先固定 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"`
}

Go test2json TestEvent 与 Action、OutputType、Output 字段关系框图 — 图1：先看 TestEvent 与 Action、OutputType、Output 三个字段框；解析时由 Action 判断事件类别，再用 OutputType 解释 Output 的语义，字段为空也必须保留原始输出。

这个结构体故意给新增字段保留 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，否则可能把其他事件误判成日志。

Go 1.27 OutputType 与 frame、error、error-continue 分类关系框图 — 图2：查看 OutputType 连接的三个分类框；frame 用于单独展示测试框架行，error 开启错误记录，error-continue 只追加到同一测试的当前错误。

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 写入完整日志，便于回查数据源。