SkyWalking Go探针是对接go-zero最轻量可靠的方式，因其基于原生HTTP/gRPC拦截和context透传，无需修改框架代码；而go-zero内置trace模块封闭且协议不兼容，硬改易出错断裂。
go-zero 本身不内置 SkyWalking 客户端支持，但可通过标准 OpenTracing / OpenTelemetry 协议桥接。直接用 skywalking-go 探针是最轻量、最可靠的方式——它不依赖 go-zero 框架内部机制，而是基于 Go 原生 HTTP/gRPC 拦截和 context 传递实现链路透传。
为什么不能直接用 go-zero 的 trace 包对接 SkyWalking
go-zero 自带的 trace 模块（如 trace.StartServerSpan）是封闭设计：它只适配自家 tracespec 接口，且默认输出到 Zipkin 格式或自定义 reporter。SkyWalking 的数据协议（v3 gRPC）、Span 结构（含 serviceInstance、peer 等字段）、采样控制逻辑都与之不兼容。硬改 go-zero 源码或包装 reporter 容易出错，且升级后易断裂。
推荐方案：用 skywalking-go agent 替代 go-zero trace
官方维护的 skywalking-go（https://github.com/apache/skywalking-go）已支持 HTTP Server、gRPC Server/Client、MySQL、Redis 等常见组件，且对 go-zero 零侵入。关键点如下：
- 无需修改
go-zero的Restful或RpcServer启动逻辑，只需在main()中初始化探针 - HTTP 请求自动注入/提取
sw8header（不是trace-id），go-zero的TracingHandler可直接移除 - gRPC 场景下，需显式将
skywalking-go的 interceptor 注入grpc.DialOption和grpc.ServerOption - 服务名必须通过
SW_AGENT_NAME环境变量设置，不能靠go-zero的ServiceConf.Name
示例初始化代码：
func main() {
// 必须在任何 HTTP/gRPC server 启动前调用
if err := swagent.Start(&swagent.Config{
ServiceName: os.Getenv("SW_AGENT_NAME"),
CollectorBackend: os.Getenv("SW_AGENT_COLLECTOR_BACKEND_SERVICES"),
}); err != nil {
log.Fatal(err)
}
defer swagent.Stop()
// 启动 go-zero rest server（无需再 wrap TracingHandler）
srv := rest.MustNewServer(rest.RestConf{
Port: 8080,
})
// ... 注册 handler
srv.Start()
}
gRPC client/server 的 Span 透传要手动补全
skywalking-go 默认只处理顶层 gRPC 调用，但 go-zero 的 RPC client（如 zrpc.Client）内部封装了 grpc.Dial，若不显式注入 interceptor，下游服务收不到 parent span。必须做两件事：
- 创建 client 时，用
zrpc.WithDialOption(grpc.WithUnaryInterceptor(swap.UnaryClientInterceptor())) - 启动 server 时，在
zrpc.NewServer的Options中加入grpc.UnaryInterceptor(swap.UnaryServerInterceptor())
注意：swap 是 skywalking-go 提供的拦截器包，不是 go-zero 自带的。漏掉任一端，链路就会断成两段。
常见坑：context 丢失和异步 goroutine 中 Span 不延续
go-zero 大量使用 go func() { ... }() 启动协程（如日志异步刷盘、超时清理），这类 goroutine 默认不继承父 context 中的 Span。结果是：主请求链路正常，但子 goroutine 的操作（如 DB 清理、MQ 发送）完全不在 SkyWalking 中显示。
修复方式只有两种：
- 用
swcontext.WithContext(ctx, span)显式传递上下文（需先从当前 context 提取 span） - 避免在关键路径上无 context 启动 goroutine；改用
swcontext.Go（skywalking-go提供的封装）
例如：
// ❌ 错误：丢失 Span
go func() {
db.Exec("DELETE FROM tmp_log WHERE ts < ?", time.Now().Add(-24*time.Hour))
}()
// ✅ 正确：延续 Span
span := swcontext.GetSpan(ctx)
go swcontext.Go(ctx, func(ctx context.Context) {
db.Exec("DELETE FROM tmp_log WHERE ts < ?", time.Now().Add(-24*time.Hour))
})
真正难的不是集成，而是确保所有跨 goroutine、跨中间件、跨 RPC 的 context 都被正确携带——这需要逐个检查 go-zero 的扩展点（如 middleware、interceptor、model 层调用），而不是只改入口。 
