Go语言Gin框架集成 Jaeger 实现分布式链路追踪-Golang-PHP中文网

jaeger客户端初始化报invalid endpoint的根本原因是传输地址格式错误或服务未就绪：udptransport需用宿主机ip（如172.17.0.1:6831）而非localhost，httptransport地址必须完整含协议与路径（如http://jaeger:14268/api/traces）。

go语言gin框架集成 jaeger 实现分布式链路追踪

Jaeger 客户端初始化时为什么总是报 `invalid endpoint`？

根本原因是 jaeger.NewUDPTransport 或 jaeger.NewHTTPTransport 的地址格式不对，或服务未就绪。Gin 本身不带链路追踪能力，必须显式构造 tracer 并注入到请求上下文。

UDPTransport 地址写成 "localhost:6831" 是常见写法，但若 Jaeger Agent 用 Docker 运行且 Gin 在宿主机启动，localhost 指向的是容器内环回，应改用宿主机 IP（如 "172.17.0.1:6831"）或直接复用 Docker 网络别名（如 "jaeger:6831"）
用 HTTPTransport（端口 14268）时，URL 必须带协议和路径："http://jaeger:14268/api/traces"，漏掉 /api/traces 就会返回 404 并静默失败
建议启动时加健康检查：调用 transport.Close() 前先发一个空 span 测试连通性，避免上线后才发现 tracer 不工作

Gin 中间件里怎么把 `span` 正确塞进 `context.Context`？

不能只调用 opentracing.StartSpanFromContext，必须用 opentracing.ContextWithSpan 把新 span 显式写回 context，否则下游中间件或 handler 拿不到。

Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载，版本号 1.9.0，适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载

错误写法：span := opentracing.StartSpanFromContext(c.Request.Context(), "http-server") —— span 创建了，但没写回 context
正确写法：ctx := opentracing.ContextWithSpan(c.Request.Context(), span)，再用 c.Request.WithContext(ctx) 构造新 request
务必在中间件末尾调用 span.Finish()，否则 trace 会卡在 pending 状态；建议用 defer span.Finish() 配合 span.SetTag("http.status_code", c.Writer.Status()) 记录状态码

为什么 Gin handler 里用 `opentracing.SpanFromContext` 拿不到 span？

多数情况是中间件顺序错了 —— 自定义 tracing 中间件必须在所有依赖 span 的中间件之前注册，比如 gin.Logger() 或自定义 auth 中间件如果提前读取了 c.Request.Context()，而那时 span 还没注入，就会拿到 nil。

Gin 中间件注册顺序决定执行顺序：r.Use(tracingMiddleware) 必须放在最前面
如果用了 gin.Recovery()，它内部 panic 恢复时会新建 context，导致 span 断裂；需在 Recovery 中间件里手动从原始 context 提取 span 并续传（较复杂，建议优先用 defer + recover 手动捕获）
跨 goroutine 场景（如 go func() {...}()）必须显式传递带 span 的 context，context.Background() 会导致子协程 trace 断开

Jaeger UI 里看不到 DB 查询或 HTTP 调用的子 span？

因为默认只埋点了 Gin HTTP 入口，DB 和 outbound HTTP 请求需要各自适配 OpenTracing API，不是自动发生的。

MySQL：用 github.com/go-sql-driver/mysql 时不生效，得换 github.com/ziutek/mymysql 或更推荐 github.com/DATA-DOG/go-sqlmock + 手动 wrap database/sql driver，或直接用 jaeger-client-go/inject 注入 span context 到 query 参数中
HTTP outbound：不用 http.DefaultClient，改用 httptrace.ClientTrace 或封装 http.RoundTripper，在 RoundTrip 中调用 tracer.StartSpanFromContext 并 inject jaeger.BinaryCarrier
注意 span 名称不要全用 "db.query"，应按 SQL 类型区分，比如 "db.select_user"，否则 Jaeger 聚合后无法识别瓶颈点

实际跑起来之后，最容易被忽略的是 span 的生命周期管理：一个请求对应一个 root span，每个子操作生成 child span，但 span 的 Finish 时间点错位（比如在 goroutine 里 finish 早于实际完成），会导致 trace 图谱错乱甚至数据丢失。调试时优先看 Jaeger 的 duration 和 logs 标签，而不是只盯 service name。