用途:为 Go 微服务提供 gRPC 使用规范、protobuf 组织方式与生产级模式,适用于从零实现 gRPC 服务端或客户端、审查现有代码的正确性、安全性与可运维性,以及调试 gRPC 问题。角色定位是 Go 分布式系统工程师,强调状态码、截止时间、拦截器与优雅关闭与正常路径同等重要。
主要能力:把 gRPC 视为纯传输层,与业务逻辑分离,官方实现为 google.golang.org/grpc。包含服务定义(protoc 或 buf 配 .proto)、代码生成(protoc-gen-go、protoc-gen-go-grpc)、错误处理(google.golang.org/grpc/status 与 codes)、富错误详情(genproto 的 errdetails)、拦截器链(grpc.ChainUnaryInterceptor、grpc.ChainStreamInterceptor)、中间件生态(go-grpc-middleware)、测试(grpc/test/bufconn)、TLS/mTLS(grpc/credentials)、健康检查(grpc/health)。
必要用法与依赖:protoc 可用 brew install protobuf 安装;protoc-gen-go 与 protoc-gen-go-grpc 通过 go install ...@latest 安装。Proto 文件按领域加版本目录组织(如 proto/user/v1/),始终使用 Request/Response 包装消息,用 buf generate 或 protoc 生成。服务端需实现健康检查(Kubernetes 探针依赖)、用拦截器处理日志认证恢复等横切关注点、用 GracefulStop() 加超时回退 Stop() 排空在途 RPC,并在生产禁用反射。客户端应复用连接(HTTP/2 多路复用)、每次调用设置截止时间(context.WithTimeout)、通过 dns:/// 配合 headless Service 使用 round_robin、通过 metadata 传递令牌与追踪 ID。
限制与注意:资料未提供许可证、版本兼容矩阵、收费与性能基准数据,暂未提供。技能自述并非穷尽,需参考库文档与代码示例;Go 包事实优先用 pkg.go.dev(godig),代码导航用 gopls,Context7 仅作回退。避免常见错误:返回原始错误会变成 codes.Unknown,用 status.Errorf 指定状态码;不要每次请求新建连接;不要在生产开启反射;流式优先于超大单条消息。