beego框架无法使用java agent，必须通过skywalking-go手动集成：在main.go首行调用swgo.start()并配置sw_agent_name与collector.backend_service；beego v2.x需在app.run()前注册swgo.httphandlefilter中间件；http调用须用swgo.contexttoheader透传sw8头；日志需结合context动态注入traceid。
Beego 框架本身不支持 SkyWalking 自动埋点，必须手动集成 Lua 探针或通过 HTTP 中间件注入 trace 上下文，否则链路在网关层就断了。
Beego 无法直接用 Java Agent
Java Agent（如 skywalking-agent.jar）只对 JVM 进程生效，而 Beego 是 Go 语言框架，运行在 Go Runtime 上。试图给 Beego 应用加 -javaagent 参数会直接报错或完全无效——Go 程序根本不会加载 JVM 类路径。
常见错误现象：
- 启动时抛出
Unrecognized option: -javaagent:/path/to/skywalking-agent.jar - OAP 后台看不到 Beego 服务实例，拓扑图里只有下游 Java 服务，Beego 像个“黑洞”
所以别碰 javaagent，这条路从根上就走不通。
推荐方案：用 skywalking-go agent（v1.0+）
Apache 官方已提供 skywalking-go 探针（GitHub 主仓库），自 v1.0 起支持自动 HTTP/gRPC 埋点，兼容 Beego 的 Controller 生命周期。
实操建议：
- 在
main.go初始化处调用swgo.Start()，并传入 OAP 地址：collector.backend_service="oap-server:11800" - 确保 Beego 启动前已设置环境变量：
SW_AGENT_NAME=beego-user-service，否则上报的 service name 会是默认值 - 若使用 Beego v2.x，需在
app.Run()前注册中间件：app.InsertFilter("*", beego.BeeAppHandler, swgo.HTTPHandleFilter) - 避免在
Finish阶段手动调用swgo.Span.End()——HTTPHandleFilter已自动完成
注意：skywalking-go 当前（2026 年 8 月）对 MySQL 驱动的自动埋点仅支持 github.com/go-sql-driver/mysql，若你用的是 modernc.org/sqlite 或 pgx，得手动 wrap 查询逻辑。
跨语言链路打通的关键 Header
Beego 作为上游调用 Java 微服务时，若没透传 trace 上下文，链路会在 Beego → Java 调用处断裂。必须确保所有 http.Client 请求都携带 sw8 头（SkyWalking v3 协议标准）。
实操建议：
- 不要手写
req.Header.Set("sw8", ...)——skywalking-go提供swgo.ContextToHeader(ctx, req.Header)，自动注入完整sw8字符串 - 若 Beego 调用的是 Nginx 网关，且网关用了
skywalking-nginx-lua，则 Beego 必须发traceparent（W3C 标准）或sw8，二者选其一；skywalking-nginx-lua默认优先读sw8 - 检查 Java 服务端是否开启了
plugin.trace.ignore_path配置 —— 若 Beego 的健康检查路径（如/healthz）被忽略，会导致该路径请求不参与链路，但其他路径正常
Beego 日志与 traceID 关联
Beego 默认日志不带 traceID，查问题时无法关联链路。不能靠改 beego.BeeLogger 的 format 字符串硬塞 —— traceID 是动态的，得从当前 span 获取。
实操建议：
- 用
swgo.GetTraceID(ctx)在每个 handler 入口提取 traceID，并存入context.WithValue() - 在 Beego 的
logs.AdapterConfig中自定义Format函数，从 context 取出 traceID 插入日志前缀 - 若用 logrus/zap，直接集成
swgo/logrus或swgo/zap封装器，比自己拼接更可靠
最容易被忽略的一点：Beego 的 Recovery 中间件捕获 panic 后，原始请求 context 已丢失，此时 swgo.GetTraceID(ctx) 返回空字符串。必须在 Recovery 前就将 traceID 写入 http.Request 的 ctx 并显式传递过去。
