1. 课程导论：gRPC事务边界与错误处理协同工程的整体架构、学习目标与前置知识
1.1 为什么需要“事务边界与错误处理协同”？
在微服务架构中，单个业务操作往往跨越多个gRPC服务。当调用链中的某个节点失败时，如何保证数据一致性、如何定义“事务”的起止边界、如何将错误信号无损地传递到决策层，成为分布式系统设计的核心难题。传统单体数据库的ACID事务在分布式环境下无法直接套用，而gRPC的流式调用、超时、重试、幂等性等机制又为错误处理增加了新的维度。
本课程将聚焦于gRPC事务边界（即分布式事务的起始、提交、回滚范围）与错误处理协同（即错误码、重试策略、超时传播、状态机回滚）的工程化结合，通过真实案例展示如何在gRPC生态中构建健壮的协同工程方案。
核心洞察： 事务边界不是由数据库锁决定的，而是由业务逻辑与gRPC调用链的“错误传播契约”共同定义的。错误处理不再是事后补救，而是事务边界管理的一等公民。
1.2 整体架构：三层协同模型
本课程将gRPC事务边界与错误处理的协同工程抽象为三层架构，每层解决不同粒度的问题：
| 层级 | 名称 | 核心职责 | gRPC相关技术 |
|---|---|---|---|
| L1 | 传输层协同 | 定义请求/响应的边界，处理网络级错误（超时、断开、流中断） | gRPC Status、Deadline、Keepalive、流控 |
| L2 | 业务层协同 | 管理跨服务的事务状态，实现Saga/TCC等模式的状态机 | gRPC Interceptor、Metadata、幂等性Token |
| L3 | 观测层协同 | 追踪错误传播路径，提供可观测性数据用于事务回滚决策 | gRPC Tracing、Metrics、结构化日志 |
三层之间通过错误传播契约连接：传输层的错误（如DEADLINE_EXCEEDED）会被业务层拦截并转换为事务状态（如“需重试”或“需回滚”），观测层则记录整个链路的错误轨迹，用于事后审计和补偿。
1.3 学习目标
完成本章节及后续课程后，你将能够：
- 定义事务边界：在gRPC调用链中准确划分事务的起始、暂停、提交和回滚范围，避免“过度事务”或“事务泄漏”。
- 设计错误传播契约：为每个gRPC服务定义清晰的错误码规范、重试语义和幂等性保证，使错误信号在服务间无损传递。
- 实现协同状态机：使用gRPC Interceptor和Metadata实现Saga、TCC等分布式事务模式的状态机编排。
- 构建可观测性：通过gRPC Tracing和结构化日志追踪错误传播路径，为事务回滚提供决策依据。
- 规避常见陷阱：识别并避免超时放大、重试风暴、错误码歧义等工程反模式。
学习建议： 本课程假设你已具备gRPC基础调用能力。如果你对gRPC的Unary/Server Streaming/Client Streaming/Bidirectional Streaming四种调用模式尚不熟悉，建议先快速回顾官方文档。
1.4 前置知识清单
为了确保学习效果，请确认你已掌握以下知识点。我们将通过一个快速自测表格帮助你定位薄弱环节：
| 知识领域 | 具体要求 | 自测问题 |
|---|---|---|
| gRPC基础 | 理解四种调用模式、proto定义、服务端/客户端实现 | 能否手写一个带双向流的gRPC服务？ |
| 错误处理 | 熟悉gRPC StatusCode（如OK、CANCELED、DEADLINE_EXCEEDED）及其语义 | UNAVAILABLE与INTERNAL的区别是什么？ |
| 分布式事务理论 | 了解Saga、TCC、2PC的基本概念和适用场景 | Saga的补偿操作与TCC的Cancel操作有何不同？ |
| 编程语言 | 至少熟悉Python或Go中的一种，能编写gRPC客户端/服务端代码 | 能否在30分钟内搭建一个gRPC Hello World？ |
| 可观测性 | 了解OpenTelemetry的基本概念（Trace、Span、Metric） | 如何通过Context传播Trace信息？ |
前置知识缺口处理： 如果自测发现某个领域不熟悉，建议在进入第2章前花1-2小时补充。本课程第2-5章会快速回顾关键概念，但不会从头教学。
1.5 课程案例全景：在线支付平台
整个课程将围绕一个在线支付平台的gRPC服务集群展开。该平台包含以下核心服务，每个服务都涉及事务边界与错误处理的协同：
- Order Service：订单创建、状态管理（事务发起方）
- Payment Service：支付处理、退款（资金类事务，要求强一致性）
- Inventory Service：库存扣减与回滚（资源类事务，要求幂等）
- Notification Service：发送通知（最终一致性，允许异步补偿）
- Ledger Service：账务记录（审计日志，只追加不修改）
这些服务通过gRPC相互调用，形成一个复杂的分布式事务拓扑。我们将逐步引入错误场景（如支付超时、库存不足、网络分区），并展示如何通过事务边界定义和错误处理协同来保证数据最终一致性。
1.6 课程路线图
本课程共30章，分为五个模块：
- 基础篇（第1-5章）：事务边界理论、gRPC错误模型、协同工程原则。
- 传输层协同（第6-10章）：Deadline传播、重试与退避、流式错误处理、连接管理。
- 业务层协同（第11-20章）：Saga实现、TCC模式、幂等性设计、Interceptor编排、状态机回滚。
- 观测层协同（第21-25章）：Tracing集成、错误码规范、Metrics告警、日志聚合。
- 实战与反模式（第26-30章）：全链路压测、故障注入、性能调优、常见陷阱与解决方案。
课程特色： 每章都包含可运行的Python/Go代码示例、SVG架构图、以及一个“错误场景实验室”——你可以在其中模拟网络故障、超时、服务崩溃，观察事务边界如何响应。