Go trace.NewTask 如何标记一个跨 goroutine 的业务任务

如果一个请求先拆成两个 goroutine，再由第三个 goroutine 汇总结果，仅凭 goroutine 的函数名很难在 Go execution trace 里看出它们属于同一个业务操作。trace.NewTask 的作用就是建立这条逻辑关联：它返回一个携带任务的 context.Context 和一个负责结束任务的 *trace.Task。

先用 NewTask 建立可跨 goroutine 传播的任务上下文

任务和 goroutine 不是一回事。goroutine 是执行载体，Task 是一个可以覆盖多个执行载体的逻辑边界。NewTask 接收父 Context 与稳定的任务类型，返回的新 Context 才携带这个任务；后续传入这个 Context 的 trace.WithRegion 和 trace.Log 才能挂到对应任务上。

下面的示例把两个独立计算分支交给不同 goroutine，再由收尾分支等待它们。代码中的注释说明了 Context、channel 和结束点各自的职责。

package main

import (
    "context"
    "fmt"
    "runtime/trace"
)

func handleOrder(parent context.Context, orderID string) string {
    // taskType 用稳定的业务类型分类，不把每个订单号拼进类型。
    ctx, task := trace.NewTask(parent, "order-assembly")
    trace.Log(ctx, "order", orderID) // 动态订单号放在消息中，便于定位单次任务。

    left := make(chan string, 1)
    right := make(chan string, 1)

    go func() {
        // 这个阶段运行在子 goroutine，但仍使用同一个任务 Context。
        trace.WithRegion(ctx, "load-profile", func() {
            left 

这里的关键不是把 task 复制给每个分支，而是把同一个 ctx 传进去。Context 是任务的传播载体，Task 本身只需要在逻辑操作完成时结束一次。

把 Task.End 放在业务真正完成的位置

Go 文档把任务延迟定义为从任务创建到调用 End 的时间。因此 End 放早了，追踪只覆盖准备阶段；放在某个子 goroutine 里，又可能在其他分支仍未完成时就宣告任务结束。对有明确汇合点的代码，收尾函数使用 defer task.End() 通常最不容易遗漏。

End 是幂等式的记录动作：如果被调用多次，追踪的延迟测量只采用第一次调用。但这不代表可以把它散落在多个分支里；多个结束点会让代码读者难以判断哪个点才是业务完成。更稳妥的做法是让拥有汇合职责的函数负责结束，并让分支只报告结果或错误。

用 Region 和 Log 解释任务内部发生了什么

Task 解决“哪些 goroutine 属于同一项逻辑操作”，却不自动解释每个阶段。trace.WithRegion(ctx, regionType, fn) 适合包住一个 goroutine 内的连续区间；trace.Log(ctx, category, message) 适合写入一次性的业务标识。两者都应使用包含任务 Context 的 ctx。

官方文档提醒分析工具可能假定 taskType 只有有限种。如果把用户 ID、订单号或时间戳拼进 taskType，聚合结果会被拆成大量类别；把这些变化放到日志消息里，既保留定位能力，也让任务延迟分布保持可读。

检查取消、重复 End 和独立任务的边界

trace.NewTask 不会替代业务 Context 的取消机制。父 Context 被取消时，业务代码仍要通过 select 处理退出、关闭 channel 或回收资源；任务是否结束，则应由业务定义的完成点决定。取消路径也应该调用一次 End，否则追踪里可能留下没有结束点的任务。

如果一个任务内部又有可单独观察的子操作，可以把任务 Context 作为新的父 Context，再调用 trace.NewTask(ctx, "子任务类型")；文档将这种关系定义为 subtask。若只是同一 goroutine 内的阶段，不必层层创建 Task，使用 Region 更合适。

相关问题

trace.NewTask 会自动跨 goroutine 传递吗？

不会。它只把任务放入返回的 Context，必须显式把这个 Context 传给 goroutine 或下游函数；新 goroutine 不会自动继承调用方的局部变量语义。

什么时候应该用 WithRegion 而不是 NewTask？

只需要记录单个 goroutine 内的一段连续工作时用 WithRegion；操作会跨多个 goroutine，或希望得到一类任务的延迟分布时，用 NewTask。

如何生成执行追踪文件？

测试场景可以使用 go test -trace=trace.out，独立程序则用 trace.Start 和 trace.Stop 包住待观察代码，再用 Go 工具分析 trace 文件。