1. 课程导论：Go Web契约压测与gRPC故障排查全景图
微服务架构下，gRPC已成为Go生态中服务间通信的首选协议。然而，当服务出现延迟飙升、连接中断、内存泄漏或数据不一致时，开发者往往陷入“日志不够、复现困难、边界模糊”的困境。本课程将系统性地构建一套从契约验证到压测发现，再到故障定位与修复的完整方法论。
1.1 为什么需要“契约压测”？
传统压测只关注吞吐量和响应时间，却忽略了接口契约的合规性。gRPC基于Protocol Buffers定义严格的服务契约，一旦服务端或客户端违反契约（字段缺失、类型错误、枚举越界、超时策略不一致），压测数据将失去参考意义。契约压测的核心目标是在高并发场景下，同时验证：
- 功能正确性：请求与响应的字段结构、类型、取值范围完全符合proto定义。
- 性能合规性：在约定SLA内（如P99延迟<50ms）完成所有合法请求。
- 异常容错性：面对网络抖动、负载尖峰、部分节点宕机时，服务行为符合预期。
关键认知： 没有契约验证的压测，本质上是“盲测”。本课程所有案例均基于真实gRPC服务故障，从契约层面切入，避免无效排查。
1.2 课程知识体系全景
下表梳理了本课程覆盖的四大核心模块及其关联关系：
| 模块 | 核心内容 | 关键工具/技术 | 故障类型示例 |
|---|---|---|---|
| 契约设计与验证 | Proto文件规范、字段规则、向后兼容性、Oneof/Map/Enum陷阱 | protoc、buf、protovalidate | 字段类型变更导致反序列化崩溃 |
| 压测工程与指标 | 压测场景设计、流量模型、指标采集（延迟/错误/饱和度） | ghz、k6、Prometheus + Grafana | 连接池耗尽、内存泄漏、CPU饥饿 |
| 故障定位与诊断 | 分布式追踪、CPU/内存/goroutine分析、gRPC状态码语义 | pprof、trace、gRPC interceptor、Wireshark | DeadlineExceeded、ResourceExhausted |
| 修复与加固 | 重试/退避策略、限流/熔断、连接管理、优雅关闭 | gRPC retry、circuit breaker、resilience4go | 级联超时、雪崩效应 |
1.3 gRPC故障排查全景图
下图展示了从“压测触发异常”到“根因修复”的完整排查链路，以及各阶段涉及的关键组件与数据流：
1.4 典型故障场景速览
本课程将深入剖析以下高频故障模式，每个模式都配有完整的压测复现、诊断过程与修复方案：
- Deadline 传播断裂：客户端设置超时，但服务端未正确传递Context，导致goroutine泄漏。
- 消息体过大引发OOM：单条gRPC消息超过4MB默认限制，服务端内存飙升。
- 连接池耗尽与雪崩：短连接未复用，瞬时并发导致端口耗尽，触发级联超时。
- Enum/Oneof 契约不兼容：服务端新增枚举值，旧客户端反序列化抛出UnknownEnum异常。
- 流式RPC背压失效：服务端推送速度远超客户端消费能力，导致内存堆积。
学习建议： 建议在本地搭建一个包含2~3个gRPC服务的Demo集群（可使用docker-compose），跟随课程逐步复现每个故障场景。本课程所有压测脚本和proto文件均可在配套代码仓库中找到。
1.5 课程产出与能力目标
完成本课程后，你将具备以下核心能力：
- 独立设计并执行gRPC契约压测方案，覆盖正常与异常流量。
- 熟练使用pprof、trace、gRPC状态码、分布式追踪等手段定位故障根因。
- 掌握gRPC连接管理、重试退避、限流熔断等生产级加固策略。
- 建立从“契约验证 → 压测发现 → 诊断修复 → 回归监控”的闭环工程思维。
接下来，我们将从第2章开始，手把手搭建契约压测环境，并编写第一个基于proto验证的压测脚本。