Go 1.27 go test -json 怎样按 OutputType 区分错误与帧输出

如果日志采集程序还在根据 === RUN、--- FAIL 或缩进空格猜测试输出类型，Go 1.27 已经提供了更稳定的字段：当 go test -json 产生 "Action":"output" 事件时，可以读取可选的 OutputType。它能区分普通输出、测试框架帧、错误首段和多行错误的续段。

官方地址：https://go.dev/cmd/test2json/

先确认 OutputType 出现在哪类事件

Go 的测试 JSON 是按行输出的事件流，不是一个包住全部结果的大 JSON 数组。每行都可以解码成一个测试事件；Action 描述事件类型，Output 通常只在 Action 为 output 时出现。Go 1.27 为这类输出事件增加了可选的 OutputType。

因此，消费端的第一条规则是先判断 Action，再解释 OutputType。pass、fail、run 等事件没有必要强行读取这个字段；没有 OutputType 的 output 事件也不等于异常。

区分 frame、error 与 error-continue

OutputType 的值可以直接映射为日志消费端的语义：

这里最容易误判的是多行错误。首行可能是 error，后续行是 error-continue；如果消费端把每一行都作为独立告警，就会把一次测试失败拆成多条事件。另一个误区是把 frame 当作错误，因为失败报告的边框也可能出现在 frame 中，但它描述的是测试框架输出。

用 Go 结构体消费 JSON 流

下面的示例只负责解析和分类，不执行测试本身。它按标准输入逐行解码，遇到 output 事件时读取 OutputType，并保留包名与测试名，便于后续写入日志系统。

package main

import (
    "bufio"
    "encoding/json"
    "fmt"
    "io"
    "os"
)

// TestEvent 对应 go test -json 的一行事件，只声明消费端关心的字段。
type TestEvent struct {
    Package    string `json:"Package"`
    Test       string `json:"Test"`
    Action     string `json:"Action"`
    Output     string `json:"Output"`
    OutputType string `json:"OutputType"`
}

func main() {
    scanner := bufio.NewScanner(os.Stdin)
    // 放大单行上限，避免较长测试日志被 Scanner 默认限制截断。
    scanner.Buffer(make([]byte, 4096), 1024*1024)

    for scanner.Scan() {
        var event TestEvent
        if err := json.Unmarshal(scanner.Bytes(), &event); err != nil {
            // 单行格式损坏时报告位置，但继续处理后续事件。
            fmt.Fprintf(os.Stderr, "decode test event: %v\n", err)
            continue
        }
        if event.Action != "output" {
            continue
        }

        kind := event.OutputType
        if kind == "" {
            // OutputType 缺省表示普通输出，不要把它升级为错误。
            kind = "regular"
        }
        fmt.Printf("package=%q test=%q type=%s text=%q\n", event.Package, event.Test, kind, event.Output)
    }
    if err := scanner.Err(); err != nil && err != io.EOF {
        // 读取管道中断时返回真实错误，避免误报为测试成功。
        fmt.Fprintf(os.Stderr, "read test stream: %v\n", err)
        os.Exit(1)
    }
}

示例把空值转换为内部的 regular 标签，只是为了让下游分类更直观；原始 JSON 仍然应保留。若要把错误首段和续段合并，应以 Package、Test 为上下文键，并按输入顺序追加文本。

处理缺省值和多测试并发输出

多个测试并行运行时，事件可能在同一个 JSON 流中交错出现。官方格式使用 Package 区分包，使用 Test 区分具体测试；包级事件通常没有 Test。因此不能只维护一个全局的“当前错误缓冲区”，否则一个测试的 error-continue 可能被追加到另一个测试。

type streamKey struct {
    Package string
    Test    string
}

// appendOutput 把错误首段与续段放入同一测试上下文，避免跨测试串线。
func appendOutput(buffers map[streamKey]string, event TestEvent) {
    if event.Action != "output" {
        return
    }
    key := streamKey{Package: event.Package, Test: event.Test}
    switch event.OutputType {
    case "error", "error-continue":
        // 两种错误类型都保留原始顺序，续段不会单独生成告警。
        buffers[key] += event.Output
    case "frame":
        // frame 是测试框架信息，单独存储或展示，不混入错误正文。
    default:
        // 空值和未来未识别值先按普通输出保存，避免丢失信息。
        buffers[key] += event.Output
    }
}

生产环境中可以把 buffers 替换成带上限的聚合器，并在收到 pass 或 fail 事件后结束对应上下文。不要只依赖 OutputType 推断最终测试结果：最终状态仍由 Action 的 pass、fail、skip 等事件表达。

常见问题

OutputType 为空是不是 JSON 解析失败？

不是。官方格式允许该字段缺省，空值表示普通输出。只有整行 JSON 无法解码时，才应记录解析错误。

error-continue 能单独作为一条告警吗？

通常不应该。它表示多行错误的后续内容，应结合相同的包名和测试名追加到前面的 error 事件。

frame 能不能用来判断测试失败？

不能。frame 只表示测试框架输出，最终成功或失败应读取对应的 pass、fail 事件。

并行测试为什么需要 Package 和 Test 两个字段？

因为事件会交错，Package 能区分包，Test 能区分包内的测试；包级事件可能没有 Test，消费端要允许这个字段为空。