GoMicro v4+ 与 Gin 混用必须手动桥接 context，因两者 context 体系独立，直接传 *gin.Context 会导致 traceID 丢失、超时失效、中间件断裂；需用 c.Request.Context() 提取并注入 metadata 后传入 client 调用。
GoMicro v4+ 与 Gin 混用必须手动桥接 context
gin 的 *gin.Context 和 go-micro 的 context.Context 是两套独立体系，直接传参会导致 metadata（如 traceID、token）丢失、超时控制失效、中间件链断裂。常见现象是：调用下游服务后日志里看不到 traceID，或 ctx.Deadline() 返回零值。
正确做法是显式转换：
- 用
gin.Context.Request.Context()提取原始context.Context - 用
metadata.Set()注入必要字段（如"trace-id","auth-token"） - 调用 go-micro client 时传入该 context，而非
*gin.Context本身
示例片段：
func handler(c *gin.Context) {
ctx := c.Request.Context()
ctx = metadata.Set(ctx, "trace-id", c.GetHeader("X-Trace-ID"))
ctx = metadata.Set(ctx, "auth-token", c.GetHeader("Authorization"))
resp, err := serviceClient.Call(ctx, req)
// ...
}
服务注册中心默认是内存型 mdns，跨容器必挂
go-micro v4+ 默认注册中心是 mdns，不配任何参数就运行，服务只在本机进程间可见。Docker 容器、K8s Pod、远程测试环境全连不上——但不会报错，只会让客户端一直卡在 service not found 或无限重试。
必须显式指定注册中心：
- 本地多进程调试可加：
--registry=mdns --registry_address=192.168.1.100:5353（绑定具体网卡） - 测试/预发/生产环境必须切到 etcd：
--registry=etcd --registry_address=http://etcd:2379（注意是http://，不是etcd://） - 别依赖“自动 fallback”——go-micro 不 fallback，它就安静地用内存注册
Protobuf 代码生成已弃用 protoc-gen-micro
运行 protoc --micro_out=. 报 unknown flag: --micro_out？这不是你插件没装好，是 v4+ 彻底删了这个插件。强行沿用旧教程会静默生成空文件，或编译时报 undefined symbol。
正确生成路径只有两条：
- 标准 gRPC：用
protoc-gen-go+protoc-gen-go-grpc生成*_pb.go和*_grpc.pb.go - go-micro client/server 不再自动绑定 proto service，需手动注册：
proto.RegisterXXXHandler(service.Server(), new(Impl)) - 若还想用
proto.NewXXXService()风格客户端，只能自己写薄包装器，或降级到 v3.10.x（但 v3 不支持 Go 1.21+ module 行为）
Gin 路由和 go-micro server 共享端口需明确分工
想让 Gin 处理 REST API、go-micro 处理 gRPC，在同一端口暴露，不能靠“自动复用”。Gin 的 http.Server 和 go-micro 的 gRPC Server 是不同底层实现，硬塞一起会冲突。
可行方案只有两种：
- 用
gin-contrib/https://github.com/gin-contrib/https或自定义http.Handler将 gRPC 请求转发给 go-micro 的 gRPC server（需启用 gRPC-Web） - 更稳妥的是分端口：Gin 监听
:8080（HTTP/REST），go-micro 监听:9090（gRPC），由 API 网关统一收敛 - 若坚持单端口，必须用
grpc-gateway反向生成 REST 接口，而不是让 Gin “接管” gRPC 流量
容易被忽略的一点：go-micro v4+ 的 service.Run() 卡住，90% 是因为漏调或重复调用了 service.Init() ——它不是可选的，是启动前强制步骤。
