Go gRPC服务上线核心是确保protobuf编译正确、接口契约注册无误、连接管理配置完备：需用v1.33+ protoc-gen-go-grpc生成RegisterXXXServer函数，NewServer后显式调用注册，Dial时按环境配insecure或TLS凭证，并启用健康检查与反射。
Go 语言做 gRPC 服务，核心不是“学怎么写”，而是“别在 protobuf 编译、接口契约、连接管理这三步上卡住”。只要 protoc 生成对、RegisterXXXServer 调用对、grpc.NewServer() 启动时没漏掉拦截器或 Keepalive 配置，服务基本就能跑通。
protoc 命令必须带 --go-grpc_out 且版本匹配
很多人生成的 Go 文件里没有 RegisterXXXServer 函数，或者报错 undefined: grpc.Server，根本原因是用了旧版 protoc-gen-go（v1.28 以前）只生成 .pb.go，不生成 gRPC 接口代码。
- 必须安装 v1.33+ 的
protoc-gen-go-grpc：go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
- 生成命令要拆成两步（或用
--go-grpc_opt=paths=source_relative）：protoc --go_out=. --go-grpc_out=. api.proto
- 检查生成文件：里面必须有类似
func RegisterGreeterServer(s *grpc.Server, srv GreeterServer)的注册函数，否则后续无法挂载服务
grpc.NewServer() 后必须显式调用 RegisterXXXServer
Go 的 gRPC server 不会自动扫描实现类型，也不会靠结构体标签注册。你写了 type GreeterServer struct{} 并实现了所有方法，但如果不手动调用 RegisterGreeterServer(srv, &GreeterServer{})，客户端连上去会直接报 UNIMPLEMENTED。
- 注册必须在
srv.Serve(lis)之前完成 - 如果用了拦截器（比如日志、鉴权），要在
NewServer时传入：srv := grpc.NewServer(grpc.UnaryInterceptor(authInterceptor))
- 别把
RegisterXXXServer写在 handler 函数里——它只接受*grpc.Server，不是每个请求都新建一个 server
客户端 Dial 时容易忽略 WithTransportCredentials 配置
本地开发用 insecure.NewCredentials() 没问题，但一旦部署到 K8s 或加了 TLS，不配 transport credentials 就会卡在 Connecting 状态，日志里只显示 transport: Error while dialing: connection closed before server preface received。
立即学习“go语言免费学习笔记（深入）”；
- 明文通信（仅开发）：
conn, _ := grpc.Dial("localhost:8080", grpc.WithTransportCredentials(insecure.NewCredentials())) - 启用 TLS（生产必需）：
creds, _ := credentials.NewClientTLSFromFile("ca.crt", "server.name")<br>conn, _ := grpc.Dial("api.example.com:443", grpc.WithTransportCredentials(creds)) - 如果服务端开了
RequireTransportSecurity(true)，客户端却用了insecure，连接会立刻失败，错误是connection error: desc = "transport: authentication handshake failed"
最常被跳过的其实是健康检查和反射支持——没有 grpc_health_v1.RegisterHealthServer，K8s 就没法做 readiness probe；没开 reflection.Register，grpcurl 就查不到服务列表。这些不是“可选功能”，而是上线前必须确认的基建项。
