golang + grpc 构建微服务以 .proto 文件为契约核心，通过 protoc 生成服务骨架与客户端，实现业务逻辑与传输层分离，并借助拦截器、tls、连接复用等配置保障吞吐与稳定性。
使用 Golang + gRPC 构建微服务，核心在于定义清晰的接口契约、生成高效通信代码、分离业务逻辑与传输层，并通过合理配置提升吞吐与稳定性。它不是简单“写个服务再调用”，而是围绕 Protocol Buffers（.proto）文件驱动整个开发流程。
1. 从 .proto 文件开始定义服务契约
gRPC 强制要求先写接口定义，这是保障跨语言、强类型、可演进的基础。一个典型 service 定义包含服务名、方法签名（含请求/响应消息）、流式类型标识：
- 使用 syntax = "proto3" 声明语法版本，避免默认值歧义
- 在 service 块中定义 RPC 方法，支持 unary（一发一收）、server-streaming、client-streaming 和 bidirectional streaming 四种模式
- 每个 message 字段用明确编号（如 1, 2, 3），后续兼容升级只允许新增字段或调整注释，不可重排或复用编号
- 推荐将 proto 文件单独放在 api/ 目录下，便于多服务共用和生成不同语言客户端
2. 用 protoc + Go 插件生成服务骨架与客户端
安装 protoc 编译器和 protoc-gen-go、protoc-gen-go-grpc 插件后，一条命令即可生成 Go 代码：
protoc --go_out=. --go-grpc_out=. --go-grpc_opt=paths=source_relative api/hello.proto
生成内容包括：
立即学习“go语言免费学习笔记（深入）”；
- HelloServiceServer 接口：你只需实现其中的方法，无需处理网络细节
- HelloServiceClient 类型：提供同步/异步调用方法，自动序列化、压缩、超时控制
- 请求/响应结构体：带 JSON 标签和 ProtoBuf 序列化支持，天然兼容 REST 网关（如 grpc-gateway）
3. 实现服务端：注入业务逻辑，不碰底层连接
启动 gRPC 服务只需几行代码，重点是把你的 handler 注册进去：
- 创建 grpc.Server 实例，可配置拦截器（auth、logging、rate-limiting）、Keepalive 参数、最大消息尺寸等
- 调用 RegisterHelloServiceServer(srv, &helloServer{})，其中 helloServer 是你实现的 struct，嵌入 UnimplementedHelloServiceServer 可避免未实现方法 panic
- 监听 TCP 端口（建议用 net.Listen("tcp", ":8080")），再调用 srv.Serve(lis) 启动
- 若需 TLS，传入 credentials.NewTLS(tlsConfig) 到 grpc.Creds() 选项中
4. 调用客户端：像本地函数一样发起远程调用
客户端初始化后，调用方式接近同步函数，但背后是 HTTP/2 多路复用和二进制协议：
- 用 grpc.Dial("localhost:8080", grpc.WithTransportCredentials(insecure.NewCredentials())) 连接（生产环境替换为 credentials.NewTLS(...)）
- 构造 client：newHelloServiceClient(conn)，该 client 支持 context 控制生命周期（超时、取消、截止时间）
- 发起调用：resp, err := client.SayHello(ctx, &pb.HelloRequest{Name: "Alice"})，错误类型包含 gRPC 状态码（如 codes.NotFound），可直接用于错误分类处理
- 流式调用返回 ClientStream 或 ServerStream 接口，用 Send()/Recv() 显式收发，适合日志推送、实时通知等场景
不复杂但容易忽略：proto 文件是微服务协作的“API 合同”，应纳入 CI 检查（比如禁止删除字段、强制添加变更说明）；gRPC 默认无服务发现，需配合 Consul、etcd 或 Kubernetes Service 配合使用；性能优化重点在连接复用（client 复用 conn）、合理设置流控参数（maxConcurrentStreams）、启用 gzip 压缩大 payload。
