# 干掉系统卡顿！Excel异步导出完整实战方案（百万数据也不慌）

**URL:** <https://www.shiqidu.com/t/topic/868>\
**Category:** 开发调优\
**Tags:** Java\
**Created:** [2025 年11 月 7 日 13:12 UTC](https://www.shiqidu.com/t/topic/868 "2025-11-07T13:12:31Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![caijizhushou](https://www.shiqidu.com/user_avatar/www.shiqidu.com/caijizhushou/32/528_2.png) [@caijizhushou](https://www.shiqidu.com/u/caijizhushou)\
发布日期： [2025 年11 月 7 日 13:12 UTC](https://www.shiqidu.com/t/topic/868/1 "2025-11-07T13:12:31Z")

</div>

## 🚀 干掉系统卡顿！Excel异步导出完整实战方案（百万数据也不慌）

> 8年Java开发经验沉淀，献上一份可以直接落地的异步导出Excel方案。告别“导出慢”“线程卡”“OOM”等老问题！

* * *

### 📌 背景

在企业级后端系统中， **Excel导出** 是一个几乎绕不过去的功能点。无论是报表系统、后台管理系统，还是BI平台，用户都希望“导出一切”。

但真实场景下，你一定遇到过这些问题：

- 导出数据量大， **导出接口超时** ❌
- 用户频繁导出， **线程资源被打爆** ❌
- 导出阻塞主线程， **影响系统性能** ❌
- 大文件导出， **直接OOM** ❌

有没有一种 **高性能、异步、安全、可控** 的导出方案？答案是：有！

* * *

### ☑ 目标

我们要实现一个支持以下特性的 **完整异步导出Excel方案** ：

- ✅ 异步任务，不阻塞接口
- ✅ 支持大数据量（百万级别）导出
- ✅ 导出状态可查、可取消
- ✅ 文件持久化（本地 / 对象存储）
- ✅ 支持多种格式（.xlsx、.csv）
- ✅ 任务失败原因可追踪

* * *

### 🧱 技术选型

| 模块 | 技术栈 |
| --- | --- |
| 后端框架 | Spring Boot |
| Excel工具 | [EasyExcel](https://link.juejin.cn?target=https%3A%2F%2Fgithub.com%2Falibaba%2Feasyexcel "https://github.com/alibaba/easyexcel") |
| 异步支持 | Spring Async / ThreadPoolTaskExecutor |
| 消息队列（可选） | RabbitMQ / Kafka |
| 文件存储 | 本地磁盘 or 阿里OSS / MinIO |
| 状态跟踪 | Redis / 数据库 |
| 前端交互 | 弹窗 + 轮询 / WebSocket |

* * *

### 🧩 架构设计

```lua
+-----------+ +-------------+ +-----------+ +----------------+
| 前端请求 | -----> | 导出任务接口| ---> | 入库记录任务 | --> | 异步任务执行器 |
+-----------+ +-------------+ +-----------+ +--------+-------+
                                                                         |
                                                                 +-------v------+
                                                                 | Excel导出逻辑 |
                                                                 +-------+------+
                                                                         |
                                                               +---------v---------+
                                                               | 文件存储（本地/OSS）|
                                                               +---------+---------+
                                                                         |
                                                               +---------v---------+
                                                               | 状态更新 & 结果通知 |
                                                               +-------------------+

```

### 💻 核心代码实现

#### 1. 定义导出任务实体

```java
@Data
@Entity
public class ExportTask {
    @Id
    private String taskId;

    private String fileName;
    private String status; // WAITING, RUNNING, SUCCESS, FAILED
    private String downloadUrl;
    private LocalDateTime createTime;
    private LocalDateTime finishTime;
    private String errorMessage;
}

```

#### 2. 创建任务接口（异步提交）

```java
@RestController
@RequestMapping("/export")
public class ExportController {

    @Autowired
    private ExportService exportService;

    @PostMapping("/start")
    public ResponseEntity<String> startExport(@RequestBody ExportRequest request) {
        String taskId = exportService.initExportTask(request);
        return ResponseEntity.ok(taskId);
    }

    @GetMapping("/status/{taskId}")
    public ResponseEntity<ExportTask> getStatus(@PathVariable String taskId) {
        return ResponseEntity.ok(exportService.getExportStatus(taskId));
    }
}

```

#### 3. 异步导出服务逻辑

```java
@Service
public class ExportService {

    @Autowired
    private TaskExecutor taskExecutor;

    @Autowired
    private ExportTaskRepository exportTaskRepository;

    public String initExportTask(ExportRequest request) {
        String taskId = UUID.randomUUID().toString();
        ExportTask task = new ExportTask();
        task.setTaskId(taskId);
        task.setStatus("WAITING");
        task.setCreateTime(LocalDateTime.now());
        exportTaskRepository.save(task);

        taskExecutor.execute(() -> doExport(task, request));
        return taskId;
    }

    public void doExport(ExportTask task, ExportRequest request) {
        try {
            task.setStatus("RUNNING");
            exportTaskRepository.save(task);

            String filePath = ExcelExporter.exportToExcel(request); // 核心导出逻辑

            task.setStatus("SUCCESS");
            task.setDownloadUrl(filePath);
        } catch (Exception e) {
            task.setStatus("FAILED");
            task.setErrorMessage(e.getMessage());
        } finally {
            task.setFinishTime(LocalDateTime.now());
            exportTaskRepository.save(task);
        }
    }

    public ExportTask getExportStatus(String taskId) {
        return exportTaskRepository.findById(taskId).orElseThrow();
    }
}

```

#### 4. Excel导出逻辑（EasyExcel）

```java
public class ExcelExporter {

    public static String exportToExcel(ExportRequest request) throws IOException {
        String filename = "export_" + System.currentTimeMillis() + ".xlsx";
        String filePath = "/data/export/" + filename;

        List<MyData> dataList = fetchData(request); // 分页拉取数据

        try (OutputStream os = new FileOutputStream(filePath)) {
            ExcelWriter writer = EasyExcel.write(os, MyData.class).build();
            WriteSheet sheet = EasyExcel.writerSheet("Data").build();

            int page = 1;
            while (true) {
                List<MyData> pageData = fetchPageData(page++);
                if (pageData.isEmpty()) break;
                writer.write(pageData, sheet);
            }
            writer.finish();
        }

        return filePath;
    }
}

```

### 🧠 实战Tips & 性能优化建议

#### ✅ 分页拉取数据

- 避免一次性加载全部数据，使用分页 + 游标方式处理
- 可结合 MyBatis RowBounds 或自定义 SQL 分页

#### ✅ 使用流式写入（Streaming）

- EasyExcel 支持流式写入，避免内存堆积
- 避免 `List<AllData>` 一次性写入

#### ✅ 限流 + 防抖机制

- 限制用户导出频率，避免恶意刷任务
- 可使用 Redis 做导出任务频率控制

#### ✅ 文件清理策略

- 设置导出文件过期时间，定时清理
- 或者上传到 OSS，减少本地磁盘压力

* * *

### 📦 高阶玩法（可选）

- 使用 **消息队列（MQ）** 解耦任务提交与执行
- 使用 **WebSocket** 实时推送任务状态
- 使用 **MinIO/阿里OSS/七牛云** 存储文件
- 集成 **权限系统** ，导出内容基于用户角色过滤

* * *

### 🧾 总结

高性能异步导出Excel，不再是“玄学”。只要你掌握了以下三点：

1. **异步解耦任务执行** ，不阻塞接口
2. **流式写入 + 分页查询** ，节省内存
3. **任务状态可查可控** ，提升用户体验

这套方案已经在多个企业项目中落地验证， **性能稳定，用户满意，开发也省心** 。

> 本文转自 [https://juejin.cn/post/7569055467802820650](https://juejin.cn/post/7569055467802820650)，如有侵权，请联系删除。