.proto文件错误导致gRPC代码全废：必须以syntax="proto3";开头，rpc参数返回值须为message，需正确配置go_package、stream关键字、protoc双插件输出及路径选项，服务端须注册实现，客户端须复用连接。
proto 文件写错，生成代码就全废
Go 的 gRPC 不是从 Go 结构体开始的，而是从 .proto 文件驱动的。写错一行，后续所有代码都跑不起来，而且错误提示往往很模糊（比如 undefined: pb.NewGreeterClient），实际只是因为没生成 client 接口。
- 必须以
syntax = "proto3";开头，漏掉这行或写成proto2，protoc会静默降级或生成不兼容代码 -
service中每个rpc方法的参数和返回值，必须是message类型，不能直接用string或int32 -
option go_package = "example.com/pb";必须写，它决定生成文件的包路径和 import 路径；如果只写"./;pb"，在模块化项目中极易引发import cycle或找不到包 - 流式接口要显式加
stream关键字，例如rpc SayHelloStream(stream HelloRequest) returns (stream HelloReply);，少一个stream就不是流，而是普通 unary 调用
protoc 命令漏参数，生成的代码缺关键接口
只运行 protoc --go_out=. 是最常见错误——它只生成消息结构（*.pb.go），不生成 gRPC 客户端/服务端骨架（*_grpc.pb.go），结果一调 NewXXXClient 就报未定义。
- 必须同时指定两个输出插件：
--go_out=.和--go-grpc_out=. - 必须加
--go_opt=paths=source_relative和--go-grpc_opt=paths=source_relative，否则生成的 import 路径可能错位，尤其在子目录下运行时 - 插件要提前装好：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest和go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest；旧版protoc-gen-go-grpc（v1.0 之前）已弃用，会导致编译失败 - 命令示例（推荐）：
protoc --go_out=. --go_opt=paths=source_relative \ --go-grpc_out=. --go-grpc_opt=paths=source_relative \ proto/hello.proto
服务端启动后调用报 UNIMPLEMENTED
这个错误不是网络不通，也不是 TLS 配置问题，90% 是服务端没注册实现——RegisterXXXServer 没调，或者传了 nil 实现。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须在
grpc.NewServer()后，显式调用pb.RegisterGreeterServer(s, &server{})，漏掉这句，gRPC 服务器根本不知道该把请求路由给谁 -
&server{}必须实现对应 service 接口里的全部方法，少一个就会导致整个 service 不可用（不是单个方法报错，是整个 service 返回UNIMPLEMENTED） - 监听地址别硬写
:50051，先检查端口是否被占：net.Listen("tcp", ":50051")失败时一定要处理err，否则程序卡住或 panic - 开发期可加反射支持，方便调试：
reflection.Register(grpcServer)，但生产环境禁用
客户端每次 Dial 都新建连接，性能断崖下跌
在 HTTP/1.1 时代，短连接还能凑合；gRPC 基于 HTTP/2，连接复用是性能命脉。每调一次都 grpc.Dial，等于每秒触发 TCP 握手 + TLS 协商 + 流控重建，吞吐量直接归零。
立即学习“go语言免费学习笔记（深入）”；
- 全局复用一个
*grpc.ClientConn，不要在函数里 new，更不要在 for 循环里 dial - 必须配
grpc.WithTransportCredentials：生产环境用credentials.NewTLS(&tls.Config{})，禁用grpc.WithInsecure() - 加 keepalive 防空闲断连：
grpc.WithKeepaliveParams(keepalive.ClientParameters{Time: 30 * time.Second})，否则 Nginx、AWS NLB 等中间件会在 60 秒无流量后主动 kill 连接 - 大消息要调大接收上限：
grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(16 * 1024 * 1024))，默认 4MB，超了就报received message larger than max
真正卡住人的从来不是语法，而是 protoc 命令少一个 flag、RegisterXXXServer 忘调、或者客户端 conn 没复用——这些点不写死在工程规范里，靠人记，十次有九次翻车。
