如何用 EasyExcel 导出含动态表头的 JSON 数据？

💬

记录下近期业务中使用EasyExcel做相关导出时候的一些问题。项目中 EasyExcel 版本为3.0.5 版本。

🤗 EasyExcel 简介

EasyExcel（EasyExcel 官网文档）是阿里巴巴开源的基于 Java 的 Excel 处理工具，它的优势在于速度快、代码简洁，并且能高效处理大文件，避免内存溢出问题。传统的 Excel 处理工具在面对大数据量时，常常会因为占用大量内存而导致程序崩溃，而 EasyExcel 的设计使得我们无需考虑性能、内存等复杂问题，能够轻松完成 Excel 的读写操作。

💿 EasyExcel 基础使用方法

使用 EasyExcel 导出数据到 Excel 通常非常简单，下面是几种常见的写入方式，将数据导出本地或者通过网络响应流输出：

📺 业务场景描述

实际业务中，我们遇到了这样一个需求：由于业务的动态性，字段名可能会增加或修改，此时上游服务返回的数据是 com.alibaba.fastjson.JSONObject 的数据，且需要有导出Excel给其他部门同事使用数据的需要。因此，我们希望能够在生成 Excel 时自动生成对应的表头，而不是手动指定固定的表头。

这时候，如果使用EasyExcel将数据导出，只是简单将数据类替换为 JSONObject 后，会遇到问题—导出的 Excel 文件内容为空：

如果将JSONObject转为Map ，单独设置header，再导出，导出的excel 表头有了，但是内容仍是空的。

🎙 源码分析

通过断点调试，我们可以很容易的分析出 EasyExcel 写入数据时的逻辑。

当传参类型为List<JSONObject> 时，因为 JSONObject 实现 Map<String, Object> ，所以 EasyExcel 写入数据时，在 com.alibaba.excel.write.executor.ExcelWriteAddExecutor 中，会走到doAddBasicTypeToExcel 方法。