grpc服务端客户端开发核心是protoc生成代码和grpc.server/grpc.dial启停，常见问题源于插件缺失、tls未禁用、unimplementedserver未嵌入、注册传nil及流式send未检错。
gRPC 是 Go 微服务间 RPC 通信的默认选择，但不是装个库就能跑通——protoc 生成失败、连接 connection refused、调用直接 panic，几乎都源于契约、配置或生命周期管理的细节偏差。
protoc 生成 Go 代码总报错？检查插件路径和命令拆分
常见错误是 protoc 找不到 protoc-gen-go 或 protoc-gen-go-grpc，或者用了已废弃的旧语法。
- 确认两个插件已安装：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest和go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest，且$GOPATH/bin在$PATH中 - 生成命令必须拆成两步：
protoc --go_out=. --go-grpc_out=. --go-grpc_opt=paths=source_relative service.proto，不能用已废弃的--go_out=plugins=grpc:. -
.proto文件中的package service;必须与目标生成目录名一致（如生成到service/目录），否则import会失败
服务端启动就 panic：UnimplementedXXXServer 没嵌入
这是最隐蔽也最常踩的坑：gRPC 自动生成的 UnimplementedHelloServiceServer 是空实现，但你不显式嵌入它，未实现的方法调用就会直接 panic，而不是返回 status.CodeUnimplemented。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 你的 server struct 必须嵌入该类型，例如：
type helloServer struct{ pb.UnimplementedHelloServiceServer } - 哪怕只实现了一个方法，也要嵌入；否则调用其他方法时崩溃，日志里只有
panic: unimplemented - 注册时传
nil（如RegisterHelloServiceServer(srv, nil)）也会立刻 panic，哪怕还没收到任何请求
客户端 Dial 失败：“connection refused” 但端口开着
这不是网络不通，而是 gRPC 默认要求 TLS，而本地开发通常走明文 HTTP/2（h2c）。错误信息极简，容易误判。
- 开发环境必须显式禁用 TLS：
grpc.WithTransportCredentials(insecure.NewCredentials())，缺了这句，Dial就会静默失败 - 监听地址要绑定
0.0.0.0:8080而非127.0.0.1:8080，尤其在容器或远程调试时 - 想让
Dial阻塞直到连上（方便调试），加grpc.WithBlock()；生产环境应去掉，改用grpc.WithTimeout(5 * time.Second)
流式响应卡死或 Send panic？context 和 error 检查不能省
服务端用 stream.Send() 推数据时，若客户端消费慢或断连，缓冲区会堆积，最终触发 transport: failed to write a frame 或 context.DeadlineExceeded。
- 每次
Send()后必须检查错误：if err := stream.Send(msg); err != nil { return err } - 循环中持续检查
stream.Context().Err() != nil，一旦收到 cancel 或 timeout，立即退出 - 不要无节制地
Send；如需背压，可用stream.SetHeader()传元数据，或改用双向流主动Recv()确认客户端就绪
真正难的不是写完第一版能跑通的 RPC，而是当流量上来、网络抖动、客户端异常断连时，你的服务是否还在吐日志、是否泄漏 goroutine、是否把超时当成业务错误重试——这些点，全藏在 context 控制、连接复用和错误分类里，漏掉任何一个，上线后都得半夜爬起来修。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
