grpc服务端与客户端在go中需精准完成proto编译、接口实现和连接管理三步：正确安装protoc-gen-go与protoc-gen-go-grpc插件，规范编写.proto文件（含option go_package、下划线字段名），服务端监听0.0.0.0:port并阻塞运行serve，客户端复用conn、设超时上下文、显式声明传输凭证。
gRPC 服务端和客户端在 Go 里不是“配好就能跑”，关键在 proto 编译、接口实现和连接管理这三步没踩准，90% 的连不上、panic、超时都出在这儿。
proto 文件怎么写才不被 protoc 报错
Go 的 gRPC 依赖 protoc + protoc-gen-go + protoc-gen-go-grpc 三件套，缺一不可。常见错误是只装了旧版插件，导致生成的代码里没有 RegisterXXXServer 或方法签名对不上。
- 必须用
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest和go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest安装两个插件（注意不是grpc-go包） -
.proto里syntax = "proto3"后面不能跟空行或注释；package名要和 Go 模块路径一致，否则import路径会错 - 服务定义里别漏掉
option go_package，比如option go_package = "example.com/pb";，否则生成的.pb.go文件会默认进main包 - 字段名用小驼峰（如
userEmail），但 proto 字段本身必须下划线（user_email），不然 JSON 映射和反射行为会不一致
服务端启动后为什么客户端连不上 connection refused
这不是网络问题，而是 Go 服务没真正监听或监听地址不对。gRPC 默认只支持 localhost，且必须显式指定 0.0.0.0:port 才能被外部访问。
- 别用
lis, err := net.Listen("tcp", "localhost:8080")—— 这样 macOS/Linux 下外部容器或宿主机根本连不到 - 改用
lis, err := net.Listen("tcp", ":8080")或"0.0.0.0:8080"，让监听绑定到所有接口 - server 启动后要等
server.Serve(lis)阻塞运行，别在它前面加log.Println("server started")就以为服务起来了——那句日志之后代码就卡死了，没机会执行 - 如果用了 TLS，客户端必须传
credentials.NewTLS(...)，否则默认走明文，直接报transport: authentication handshake failed
客户端调用老是 context deadline exceeded
这不是服务端慢，而是客户端没设对上下文或连接没复用。gRPC 的 Conn 是长连接，但每次 grpc.Dial 都会新建连接，频繁 Dial + Close 就容易触发连接风暴和超时。
立即学习“go语言免费学习笔记（深入）”；
- 全局复用一个
*grpc.ClientConn，别每次请求都Dial再Close；关闭时机应该在应用退出时统一处理 - 调用方法时用带超时的 context：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)，而不是直接传context.Background() - 别忽略
grpc.WithTransportCredentials(insecure.NewCredentials())—— 即使本地开发，也要显式声明，否则默认要求 TLS，连localhost都失败 - 如果服务端有拦截器或中间件耗时高，超时得设在服务端
UnaryInterceptor里，客户端超时只管“发出去到收到响应”这段
如何让服务端同时支持 HTTP/1.1 和 gRPC（比如调试用 curl）
原生 gRPC 不支持 HTTP/1.1，但可以用 grpc-gateway 做反向代理。它不是“让 gRPC 服务直接响应 curl”，而是起另一个 HTTP 服务，把 REST 请求转成 gRPC 调用。
- 需要额外写
google.api.httpoption 到 proto 方法上，比如get: "/v1/users/{id}" - 生成代码时得加
protoc-gen-grpc-gateway插件，并用--grpc-gateway_out参数 - gateway 服务必须和 gRPC server 共享同一个
grpc.Server实例（通过grpc.Dial连本机 gRPC 端口），否则跨进程通信会多一层网络延迟 - 注意 gateway 默认不透传 metadata，如果鉴权信息存在 header 里（如
Authorization），得手动配置runtime.WithForwardResponseOption拦截处理
最常被跳过的其实是 protoc-gen-go-grpc 版本和 google.golang.org/grpc 版本的对应关系——差一个小版本，生成的 RegisterXXXServer 函数签名就可能少一个参数，编译不报错但运行 panic。这点没法靠文档查，只能看 go.mod 里两个模块的 commit 时间是否接近。
