📚 课程目录第1章课程导论

1. 课程导论：gRPC拦截器与GC停顿问题的背景、课程目标与学习路径

在微服务架构中，gRPC 已成为 Go 生态最主流的高性能 RPC 框架。然而，当服务流量增长到每秒数万甚至数十万请求时，拦截器（Interceptor） 与 Go 运行时垃圾回收（GC） 之间的相互作用，会引发严重的性能抖动。

典型现象：服务平均延迟正常（如 5ms），但 P99 延迟每隔几分钟会突然飙升到 200ms 以上，甚至出现超时熔断。排查后发现，GC 停顿（STW）时间在拦截器链中成倍放大。

  核心矛盾： 拦截器本质是请求/响应路径上的中间件函数，每次 RPC 调用都会创建大量临时对象（元数据、上下文、错误包装、重试状态）。高并发下，这些对象的分配速率远超 GC 的并发标记清除能力，导致 GC 周期频繁触发，STW 时间叠加，最终表现为请求超时。

以下表格总结了拦截器与 GC 停顿之间的关键关联点：

维度	拦截器行为	GC 影响	典型后果
对象分配	每次调用创建新的 `metadata.MD`、`status.Error`、`context` 包装	堆内存分配速率飙升，触发 GC 频率增加	GC 周期从 1 次/分钟变为 10 次/分钟
指针引用	拦截器链中多层闭包捕获外部变量	GC 扫描根对象范围扩大，标记阶段耗时增加	STW 时间从 1ms 增加到 8ms
重试/超时	拦截器内部启动 goroutine 管理重试状态	goroutine 栈增长导致 GC 扫描压力上升	P99 延迟从 10ms 飙升到 300ms
元数据复制	拦截器频繁复制 `metadata` 用于链路透传	大对象（>32KB）逃逸到堆，GC 压缩阶段负担加重	内存碎片化，GC 耗时波动剧烈

本课程不是泛泛的 gRPC 入门，而是聚焦于 生产环境中真实发生的性能事故。完成本课程后，你将具备以下能力：

适用人群： 本课程面向有 1 年以上 Go 开发经验、正在或即将维护高并发 gRPC 服务的工程师。你需要熟悉基本的 gRPC 拦截器用法，但不要求深入理解 GC 原理——课程会从基础讲起。

课程共 30 章，分为四个阶段，循序渐进地构建从理论到实战的知识体系：

下图展示了课程的整体知识结构与学习路径：

真实案例驱动： 每个优化章节都来自作者在金融、电商场景中遇到的真实事故，附带完整的排查过程与代码修复 diff。
可复现的实验环境： 提供 Docker Compose 编排的 gRPC 服务 + Prometheus + Grafana 监控栈，所有优化效果均可本地验证。
性能指标量化： 每个优化方案都会给出优化前后的 GC 停顿时间、P99 延迟、内存分配速率对比数据。
避坑指南： 总结拦截器优化中常见的 10 个反模式（如过度使用 sync.Pool、忽略 context 传播开销等），避免你走弯路。

重要提示： 本课程不推荐“一刀切”地禁用拦截器或盲目调大 GOGC。优化必须基于数据，而非直觉。课程中所有调优建议都附带 风险说明 和 回滚方案。

知识领域	要求	课程中如何补充
Go 语言基础	熟悉 goroutine、channel、interface	第 2 章快速回顾拦截器相关语法
gRPC 基础	了解 Unary/Stream 调用、proto 定义	第 3 章深入拦截器注册与执行链
性能分析工具	至少使用过 `go tool pprof`	第 5-6 章手把手教学 trace 与 GC 日志
Linux 基础	能查看进程内存、CPU 指标	第 7 章介绍容器环境下的性能采集

如果你对上述某些领域还不熟悉，不必担心——课程会在前 8 章中通过 “快速预热” 环节补齐必要知识，确保你能够顺利进入后续的深度优化内容。