gRPC 核心技术全景知识库¶

欢迎查阅 gRPC 核心技术全景知识库。本知识库致力于系统化、深层次地梳理 gRPC（Google Remote Procedure Call）技术栈，从底层原理到生产治理，涵盖架构设计、Protocol Buffers、传输机制、核心特性、安全性以及高并发实战。

知识体系全景导航¶

mindmap
  root((gRPC 核心体系))
    基础与架构
      设计哲学与演进
      RPC vs REST vs GraphQL
      开发工具链安装 (protoc / buf / grpcurl)
      10分钟快速入门
    数据与序列化
      Proto3 语法规范
      Varint / TLV 编码机制
      接口兼容演进原则
    传输与协议
      4 种 RPC 通信模式
      HTTP/2 帧与多路复用
      Wire Protocol 协议细节
    核心机制
      Metadata 上下文传递
      Rich Error 错误模型
      Deadline 级联超时
      Interceptor 拦截器设计
      Keepalive 连接探活
    服务治理
      客户端负载均衡 / xDS
      Name Resolver 服务发现
      gRPC 反射与调试工具
      gRPC-Gateway 与 Web 适配
    安全性
      TLS / mTLS 双向认证
      Token / JWT / CallCredentials
    实战工程
      Go 生产级工程规范
      Python 同步与异步
    运维与调优
      ghz 压测与性能调优
      抓包排查与常见故障
      优雅停机与健康检查

章节速览¶

章节模块	核心内容	重点技术点
01. 概述与核心概念	gRPC 架构设计、演进历史与选型对比	Stub 桩机制、IDL 驱动契约、REST vs gRPC 性能维度对比
02. Protocol Buffers	序列化格式规范与底层二进制编码	Varint 变长整型、ZigZag 编码、Tag-Length-Value、向前向后兼容性
03. 传输层与通信模式	四种调用模式与 HTTP/2 底层交互	Unary、Server/Client/Bidirectional 流、多路复用、Trailer 帧设计
04. 核心功能与高级特性	生产级微服务核心基础构件	Metadata 传播、Rich Error 结构、级联 Deadline 取消、AOP 拦截器链
05. 治理与系统架构	分布式微服务治理体系	客户端均衡（Pick First / Round Robin）、xDS 动态配置、服务发现、gRPC-Gateway
06. 安全与认证体系	链路加密与身份凭证体系	TLS/mTLS 证书交互流程、CallCredentials、Per-RPC Token 注入
07. 多语言实战开发	工业级工程化实现范例	Go 语言完整工程实践、Python 异步 `asyncio` gRPC 服务实现
08. 性能调优与故障排查	高并发优化策略与排错宝典	连接复用调优、ghz 压测方法、常见状态码根因分析、Wireshark 抓包技巧
09. 最佳实践与微服务规范	生产就绪微服务建设方案	Graceful Shutdown 平滑重启、Health Check 协议标准、Buf 工程化管理

本知识库技术特色¶

深入底层原理：不只停留在 API 调用，深入拆解 HTTP/2 Frame、Varint 字节流与二进制编解码细节。
配图丰富直观：大量采用 Mermaid 流程图、时序图与架构图，清晰呈现交互全貌。
贴合生产实践：所有示例与方案均按生产级服务治理标准设计，涵盖拦截器、追踪凭证、超时熔断与平滑启停。
CI/CD 自动化：基于 MkDocs Material 构建，通过 GitLab CI 自动化发布至 GitLab Pages。