protoc-gen-micro 已被彻底移除，v4+ 版本无法生成 .micro.go 文件；正确做法是用 protoc-gen-go 和 protoc-gen-go-grpc 生成标准 gRPC 接口（_pb.go 和 *_grpc.pb.go），再手动集成 client/server。
protoc-gen-micro 已被彻底移除，v4+ 版本无法生成 *.micro.go 文件——这不是环境问题，是框架主动废弃该插件。所有照搬 v2/v3 教程的代码，在 v4+ 上要么报 unknown flag: --micro_out，要么静默产出空文件。
protoc-gen-micro 报错或生成空文件？换插件，别硬扛
Go Micro v4 起不再提供 protoc-gen-micro，也不再支持 --micro_out 参数。强行保留旧命令会直接失败或无声跳过。
- 正确做法：用
protoc-gen-go+protoc-gen-go-grpc生成标准 gRPC 接口文件（*_pb.go和*_grpc.pb.go） - 生成命令示例：
protoc --proto_path=. --go-grpc_out=. --go_out=. proto/product/product.proto - 旧版
*.micro.go中的客户端封装（如proto.NewProductService）已不存在，需手动包装或降级到 v3.10.x（但 v3 不兼容 Go 1.21+ module 行为） - 若已有大量
*.micro.go依赖，建议先切到 v3.10.x 过渡，而非在 v4+ 上打补丁
service.Run() 卡住或 client 找不到服务？检查 registry 是否真生效
v4 默认注册中心是内存型 mdns，只在单机多进程调试时有效；跨容器、跨机器时它不报错，但服务根本不会注册到网络中，导致 client 调用返回 service not found 或无限等待。
- 生产/测试必须显式配置：
--registry=etcd --registry_address=http://etcd:2379（注意是http://，不是etcd://） -
micro.NewService()不再自动加载插件，micro.WithRegistry(etcd.NewRegistry())必须显式传入，否则日志只显示no registry configured，无 panic 也无 fallback - 服务名只能含小写字母、数字、短横线（
-），user_service或UserSrv会被拒绝注册，且无明确提示 - etcd key 路径不支持下划线，注册失败时服务“消失”，但不会报错——这是最易被忽略的静默故障点
gin handler 调用 go-micro client 时 traceID 断掉？context 必须桥接
*gin.Context 和 context.Context 类型不兼容，直接传 r.Context() 给 client.Call，所有 ctx.Value() 都是 nil，traceID、user_id 等 metadata 全丢失。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须用
micro.WithContext(ctx, r.Context())显式桥接，其中ctx是 go-micro 的 context，r是 *gin.Context - metadata 需手动提取：
traceID := r.Request.Header.Get("X-Trace-ID")，再注入：ctx = metadata.Set(ctx, "traceID", traceID) - 若用了自定义中间件往
gin.Context塞值（如r.Set("user_id", "123")），桥接前得手动拷贝：ctx = context.WithValue(ctx, "user_id", r.GetString("user_id")) - v4 的
selector和registry解耦，bridge 后的 ctx 若没带 selector 实例，负载均衡逻辑可能不触发
micro.NewClient 总连 localhost:8080？默认直连，不查注册中心
v4 的 micro.NewClient() 在未配置 registry 时，不尝试服务发现，而是硬编码直连 localhost:8080——这不是 bug，是设计上要求“是否走注册中心”必须显式声明。
立即学习“go语言免费学习笔记（深入）”；
- 想走服务发现：初始化 client 时传
micro.Registry(service.Registry())，确保和 service 使用同一 registry 实例 - 想直连固定地址（如本地调试）：用
micro.WithAddress("10.0.1.5:9090")，此时 registry 配置会被忽略 - 跨语言调用（如 Python micro service）必须加
micro.WithContentType("application/json")，否则默认用 protobuf+binary 编码，对方解不开 - 绕过 go-micro 直接 new
grpc.ClientConn会跳过负载均衡、重试、selector 等治理能力，QPS 高时容易掩盖真实超时问题
go get 了 etcd 插件，不显式调用 etcd.NewRegistry() 并传给 micro.WithRegistry()，它就等于没装。 
