Golang二进制能直接运行在distroless镜像中，因为Go默认静态链接所有依赖，编译出的main不依赖glibc或动态库；distroless镜像仅含内核接口，无shell、包管理器，恰为Go应用理想环境。
为什么Golang二进制能直接跑在distroless镜像里
因为Go默认静态链接所有依赖，编译出的main不依赖glibc或动态库。而distroless镜像只含操作系统内核接口，没有包管理器、shell甚至/bin/sh——这恰恰是Go应用最理想的运行环境。
常见错误是Dockerfile里用FROM ubuntu:22.04做最终镜像，白白增加300MB体积和CVE风险；正确做法是用FROM gcr.io/distroless/static:nonroot，再COPY --from=builder /app/main .。
- 务必关闭CGO：
CGO_ENABLED=0 go build，否则会动态链接libc - 加
-ldflags="-s -w"去掉调试符号和符号表，可再减小15%体积 - 如果服务需解析DNS（比如连etcd），得换
distroless/base，它带musl libc
Service Mesh中Sidecar如何感知Go服务的健康状态
Envoy Sidecar本身不理解Go代码，它只认标准HTTP/gRPC探针。Go服务必须暴露/healthz或/readyz端点，且返回HTTP 200，否则K8s会反复重启Pod。
别直接用http.ListenAndServe(":8080", nil)——它没健康检查逻辑。推荐用net/http手动注册，或用go-chi/chi这类路由库统一处理：
立即学习“go语言免费学习笔记（深入）”；
func healthHandler(w http.ResponseWriter, r *http.Request) {
// 检查数据库连接、下游gRPC服务等关键依赖
if !dbPing() || !grpcPing() {
http.Error(w, "unhealthy", http.StatusInternalServerError)
return
}
w.WriteHeader(http.StatusOK)
}
- K8s的
livenessProbe建议设为10秒超时+3次失败即重启，避免卡死进程拖垮整个Pod -
readinessProbe要更激进：首次启动延迟设为5秒，探测间隔2秒，失败1次就摘除流量 - 别把健康检查和业务逻辑混写——它可能被高频调用，应绕过中间件、DB连接池等重开销路径
Consul服务发现时，Go客户端注册容易漏掉的关键字段
用consulapi注册服务时，只填Name和Address不够。K8s里跑的Go服务常因Tag或Meta缺失，导致API网关无法按版本路由或熔断策略失效。
必须显式设置ServiceDefinition.Tags和ServiceDefinition.Meta：
svc := &consulapi.AgentServiceRegistration{
ID: "order-service-v1-7f8d",
Name: "order-service",
Tags: []string{"v1", "canary:false"},
Meta: map[string]string{"env": "prod", "team": "payment"},
Address: "10.244.1.5",
Port: 8080,
}
-
ID必须全局唯一，建议拼接服务名+版本+Pod UID，否则滚动更新时旧实例注册信息残留 -
Tags用于Consul内置的健康检查分组和查询过滤，比如service.tags==["v1"] -
Meta不参与服务发现，但会被Istio等Mesh控制平面读取，用来生成Sidecar配置
OpenTelemetry trace上下文跨goroutine丢失的典型场景
Go里trace上下文不是线程局部存储，而是靠context.Context显式传递。最常见的丢trace场景是：启了新goroutine但没传ctx，或者用了time.AfterFunc这类闭包捕获老ctx。
正确做法是所有goroutine启动前，用trace.WithSpanContext从原ctx提取span并注入新ctx：
go func(ctx context.Context) {
// 从入参ctx提取span，新建子span
span := trace.SpanFromContext(ctx).SpanContext()
childCtx := trace.ContextWithSpanContext(context.Background(), span)
// 后续操作用childCtx，trace链路就不断
}(req.Context())
- 别用
context.TODO()或context.Background()作为goroutine起点——它们没有trace上下文 - 第三方库如
database/sql、net/http已自动集成OTel，但自定义协程必须手动传ctx - gRPC客户端调用时，确保用
grpc.WithUnaryInterceptor注入trace，否则服务间链路断裂
