1. 课程导学：报表导出服务拆分的背景与痛点、课程目标与学习路径、整体架构预览
1.1 报表导出：被低估的“慢路径”瓶颈
在大多数企业级应用中，报表导出功能通常被视为一个“辅助模块”——业务逻辑简单，无非是查询数据、组装格式、写入文件。然而，当数据量从千级增长到百万级、并发请求从个位数增长到数十甚至上百时，这个“辅助模块”会迅速演变为整个系统的性能黑洞。
典型痛点场景： 某 SaaS 平台在业务高峰期，单次导出请求占用数据库连接长达 3-5 分钟，导致核心交易接口响应超时；同时，大文件导出时 Tomcat 线程池被长时间阻塞，引发级联雪崩。
我们将报表导出服务拆分前的主要痛点归纳为以下四类：
| 痛点类别 | 具体表现 | 影响范围 |
|---|---|---|
| 资源争抢 | 导出任务长时间占用数据库连接、内存、CPU | 核心业务接口响应变慢，甚至超时 |
| 线程阻塞 | 同步导出阻塞 Tomcat/Undertow 工作线程 | 应用服务器吞吐量骤降，请求排队积压 |
| 扩展困难 | 导出逻辑与业务代码耦合，无法独立扩缩容 | 资源利用率低，运维成本高 |
| 失败重试 | 导出中途失败无断点续传，用户需重新发起 | 用户体验差，数据一致性难以保障 |
1.2 课程目标：从“单体导出”到“异步拆分”的完整实战
本课程的核心目标是带领你完成一次完整的服务拆分实战——将报表导出功能从单体应用中剥离，构建为独立的、基于 gRPC 通信的异步导出服务。通过本课程，你将掌握以下关键能力：
- 接口契约设计： 使用 Protocol Buffers 定义导出服务的请求/响应模型，明确服务边界。
- gRPC 服务开发： 实现双向流式 RPC，支持大文件分块传输与进度回调。
- 边界测试策略： 针对 gRPC 接口编写单元测试、集成测试与契约测试，确保拆分后的服务稳定可靠。
- 异步任务编排： 引入消息队列解耦导出请求与执行，实现任务状态跟踪与失败重试。
学习前提： 你需要具备 Java 基础、Spring Boot 使用经验，以及对微服务架构的基本认知。本课程不要求 gRPC 或 Protocol Buffers 的前置知识，我们会从零开始搭建。
1.3 整体架构预览：拆分后的服务拓扑
下图展示了拆分后的报表导出服务整体架构。核心变化在于：导出请求不再由业务应用直接处理，而是通过 gRPC 客户端发送给独立的导出服务，导出服务异步执行任务，并通过回调或轮询返回结果。
1.4 学习路径：从契约到测试的完整闭环
本课程共分为 6 个阶段，每个阶段聚焦一个核心主题，最终形成从接口契约设计到边界测试验证的完整闭环。
| 阶段 | 章节范围 | 核心内容 | 产出物 |
|---|---|---|---|
| 1. 基础与设计 | 第 1-4 章 | 服务拆分背景、gRPC 基础、Protobuf 语法、接口契约设计 | proto 文件、服务接口定义 |
| 2. 服务实现 | 第 5-10 章 | gRPC 服务端/客户端开发、双向流实现、拦截器与认证 | 可运行的 gRPC 服务 |
| 3. 异步与队列 | 第 11-15 章 | 消息队列集成、任务状态管理、失败重试与补偿 | 异步导出任务引擎 |
| 4. 边界测试 | 第 16-22 章 | 单元测试、集成测试、契约测试、性能测试 | 测试套件与覆盖率报告 |
| 5. 部署与运维 | 第 23-27 章 | Docker 容器化、Kubernetes 部署、监控与日志 | 部署脚本与监控面板 |
| 6. 总结与扩展 | 第 28-30 章 | 架构复盘、常见坑点、扩展方向（多租户、分片导出） | 架构决策记录 |
学习建议： 本课程强调“动手实战”。每章都配有可运行的代码示例和测试用例，建议你在阅读的同时打开 IDE 同步编码，不要只停留在“看懂”层面。遇到问题可以先查看章节末尾的“常见问题”部分，再考虑提问。