1. 课程导论

1.1 报表导出的业务价值

报表导出是企业级应用中不可或缺的基础能力，其核心价值体现在以下三个层面：

1.2 常见痛点分析

在实际生产环境中，报表导出服务经常暴露以下三类核心问题：

痛点一：超时

• 同步导出超时：当数据量超过 10 万行或涉及多表关联查询时，HTTP 连接在 30s~60s 内无法返回，导致前端请求失败、用户反复点击。
• 数据库查询超时：复杂聚合 SQL 执行时间超过数据库 statement_timeout（常见设置为 30s），查询被强制中断。
• 文件生成超时：POI / EasyExcel 等库在写入大量单元格时，JVM 堆内存飙升，GC 频繁导致处理时间不可控。

痛点二：资源竞争

• 数据库连接池争抢：多个导出任务同时发起大查询，耗尽连接池，影响在线业务正常请求。
• 内存与 CPU 争抢：单节点同时处理多个大文件导出，堆内存溢出或 CPU 飙高，导致服务整体响应变慢。
• 文件系统 IO 争抢：大量导出文件同时写入本地磁盘，IO 等待时间增加，甚至触发磁盘满告警。

痛点三：状态丢失

• 进程崩溃丢失：导出任务执行到一半时服务重启或宕机，任务状态仅保存在内存中，重启后无法恢复。
• 前端轮询丢失：用户刷新页面后，前端丢失任务 ID，无法继续查询导出进度。
• 文件过期丢失：导出完成后未及时通知用户下载，文件被定时清理策略删除，用户投诉数据丢失。

1.3 架构设计目标

基于业务价值与痛点分析，报表导出服务的架构设计应围绕以下五个核心目标展开：

1. 异步化：所有导出任务必须走异步队列，避免同步阻塞；前端通过轮询或 WebSocket 获取进度。
2. 可观测：每个导出任务具备唯一 ID，支持全链路追踪（创建→排队→执行→完成→下载→清理）。
3. 弹性伸缩：导出任务处理能力可随业务流量动态扩缩，高峰期不挤占在线业务资源。
4. 状态持久化：任务状态写入数据库或缓存，支持进程重启后恢复，保证最终一致性。
5. 资源隔离：导出服务与在线业务服务分离部署，数据库连接池、线程池、内存池独立配置。

1.4 架构总览：从同步到异步的范式转换

下图展示了报表导出服务从传统同步模式到异步架构的核心变化：

1.5 课程知识体系

本课程将围绕以下主线展开，每章均包含接口契约定义与状态同步设计：