生产环境必须显式配置gRPC连接复用、Keepalive和TLS，否则高并发下易出现连接数爆炸、空闲断连、证书校验失败；需全局单例初始化ClientConn，禁用WithInsecure，设置Keepalive参数及默认调用选项，并注意proto生成路径与版本兼容性。
grpc.Dial 默认配置在生产环境会出问题，必须显式配置连接复用、Keepalive 和 TLS —— 否则高并发下连接数爆炸、空闲断连、证书校验失败是常态。
为什么不能每次调用都 grpc.Dial
每次新建 grpc.ClientConn 会触发完整 TCP 握手 + TLS 协商，不仅延迟飙升，还会快速耗尽客户端文件描述符（Linux 默认 1024）。Kubernetes Pod 内若每秒新建 50 个连接，几分钟就可能触发 too many open files 错误。
- 连接不是“轻量对象”，而是持有 socket、TLS state、HTTP/2 stream pool 的重量级资源
-
grpc.Dial返回的*grpc.ClientConn是线程安全的，可被多个 goroutine 并发复用 - 应全局单例初始化（如放在
init()或依赖注入容器中），而非按需创建
grpc.Dial 必须设置的三个参数
缺一不可，否则在负载均衡器（如 Nginx、AWS NLB）、长连接空闲场景下大概率失败：
-
grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{}))：生产环境禁用grpc.WithInsecure()；即使内网也建议用 mTLS 或至少自签名 CA 校验 -
grpc.WithKeepaliveParams(keepalive.ClientParameters{Time: 30 * time.Second})：主动发 PING 防中间设备（如防火墙、LB）静默断连；Time建议设为 LB 空闲超时的一半 -
grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(16 * 1024 * 1024))：默认接收上限仅 4MB，大响应直接报rpc error: code = ResourceExhausted desc = grpc: received message larger than max (xxxxxx vs. 4194304)
proto 文件生成时容易忽略的路径陷阱
protoc --go_out=. 不加 paths=source_relative 会导致生成的 import 路径错误，编译失败或运行时报 unregistered service。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 正确命令：
protoc --go_out=paths=source_relative:. --go-grpc_out=paths=source_relative:. api/user.proto - 对应
.proto中的option go_package = "example.com/pb;pb"必须与实际 Go module 路径一致 - 生成的
user_grpc.pb.go里RegisterUserServiceServer函数签名若与你实现的 struct 方法签名不匹配（比如少了个context.Context参数），说明 proto 版本或插件版本不对 —— 用google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest，别用已废弃的protoc-gen-go-grpcv1.1 以下旧版
客户端调用时 context 超时和取消必须显式传入
gRPC 的 ctx 不只是传递元数据，它直接控制底层 HTTP/2 stream 生命周期。不设超时，一次卡死的后端请求会让整个 goroutine 永久阻塞。
- 永远不要用
context.Background()直接调用，至少设context.WithTimeout(ctx, 5*time.Second) - 流式调用（
stream）必须配合ctx.Done()监听，否则Recv()可能永久挂起 - 如果服务端支持 deadline 透传，客户端
ctx的 deadline 会自动转成 HTTP/2 HEADERS 帧发送，服务端ctx.Err()可同步感知
真正难的不是写通第一个 SayHello，而是让 grpc.ClientConn 在 1000 QPS 下稳定跑一周不泄漏、不断连、不静默失败 —— 所有配置项都在为这个目标服务，而不是为了“能跑起来”。
