[特殊字符]Spring Boot 后台使用 EasyExcel 实现数据报表导出（含模板、样式、美化）

在企业级系统中，数据导出 Excel 是非常常见的需求。本文基于实际项目经验，分享如何使用 EasyExcel 实现复杂报表导出，包含：

• 支持按天/按小时导出数据

• 使用模板填充 Excel

• 支持多 Sheet、多段写入

• 使用注解设置单元格样式

• 实现月度数据聚合与格式优化

  ---

  🧾 一、数据报表导出常见场景

  1. 用户行为日志导出（按小时、日、月粒度）

  2. 电商交易报表（时间区间、订单、金额汇总）

  3. 运维监控数据导出

  4. 业务经营分析数据导出（如本文场景）

  ---

  🛠️ 二、常用 Excel 导出方案对比

  技术方案	特点	优缺点说明
  Apache POI	功能强大，支持复杂格式	复杂笨重、内存占用高
  JXL	轻量级	不支持 Excel 2007+（.xlsx）
  EasyExcel（推荐）	阿里开源，流式处理，速度快	对模板语法有一定学习成本
  CSV 导出	简单快速	不支持样式、格式、合并单元格等

  ---

  🚀 三、为什么选择 EasyExcel？

  • 支持 大数据量导出，写入不容易 OOM

  • 模板填充能力强，能与设计好的 Excel 模板结合

  • 支持注解方式配置样式、美化表格

  • 支持多个 Sheet、多段写入

  • API 友好，文档完善

    ---

    🧑‍💻 四、EasyExcel 使用详解

    1️⃣ 基本写法

    EasyExcel.write(outputStream, MyData.class)
             .sheet("报表")
             .doWrite(dataList);
    

    2️⃣ 使用模板导出（推荐）

    ExcelWriter writer = EasyExcel
            .write(outputStream, MyData.class)
            .withTemplate(templateInputStream)
            .build();
    WriteSheet sheet = EasyExcel.writerSheet().build();
    writer.fill(variableMap, sheet);      // 填充 {{变量}}
    writer.write(dataList, sheet);        // 填充数据区域 {}
    writer.finish();
    

    ---

    🎨 五、样式注解介绍

    EasyExcel 提供了丰富的注解用于设置单元格样式，无需写 handler：

    @ColumnWidth(15)
    @ContentStyle(
        fillPatternType = FillPatternTypeEnum.SOLID_FOREGROUND,
        fillForegroundColor = 42,
        verticalAlignment = VerticalAlignmentEnum.CENTER,
        horizontalAlignment = HorizontalAlignmentEnum.CENTER
    )
    @ContentFontStyle(
        fontName = "宋体",
        fontHeightInPoints = 12,
        bold = BooleanEnum.TRUE
    )
    @Data
    public class StatisticsData {
        private String statTime;
        private String regionName;
        private Integer userCount;
        private BigDecimal amount;
    }
    

    解释：

    • @ContentStyle 设置单元格背景色、对齐方式等

    • @ContentFontStyle 设置字体名称、字号、加粗等

    • @ColumnWidth 设置列宽

      ---

      🧩 六、Excel 模板导出详解

      ✅ 为什么使用模板？

      使用模板导出可以：

      • 预设表格样式与布局

      • 避免 Java 中繁琐的样式处理

      • 支持多段数据写入（如月份汇总）

      • 和美术设计好的 Excel 完美结合

        📂 模板示例结构

        

        A列	B列	C列
        统计时间：	{{startTime}} ~ {{endTime}}
        当前时间：	{{currentTime}}
        月份：	{{month}}
        日期	用户数	销售额
        {data}
        月汇总：	{monthAggregation}

        🧑‍💻 Java 填充代码

        ExcelWriter excelWriter = EasyExcel
            .write(response.getOutputStream(), StatisticsData.class)
            .withTemplate(getClass().getClassLoader().getResourceAsStream("static/day_statistics_template.xlsx"))
            .autoCloseStream(false)
            .registerWriteHandler(easyExcelUtil)
            .build();
        Map map = new HashMap();
        map.put("startTime", "2025-01-01");
        map.put("endTime", "2025-01-31");
        map.put("currentTime", "2025/05/04 10:00:00");
        excelWriter.fill(map, writeSheet);
        excelWriter.write(dataList, writeSheet); // 支持多段填充
        excelWriter.finish();
        

        ---

        🔄 七、项目实战关键代码讲解

        ☑️ 数据导出主入口

        @Override
        public void downloadStatistics(LocalDateTime minTime, LocalDateTime maxTime) throws IOException {
            // 校验时间范围
            if (LocalDateTimeUtil.between(minTime, maxTime, ChronoUnit.DAYS) > 365) {
                throw new ForbiddenOperationException("查询时间区间不能超过一年");
            }
            HttpServletResponse response = ResponseUtils.getResponse();
            response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
            response.setCharacterEncoding("utf-8");
            response.setHeader(BODY_PROCESSED, "1");
            try {
                if (LocalDateTimeUtil.beginOfDay(maxTime).equals(minTime)) {
                    downloadHourStatisticsData(response, minTime); // 按小时导出
                } else {
                    downloadDayStatisticsData(response, minTime, maxTime); // 按天导出
                }
            } catch (Exception e) {
                response.reset();
                response.setContentType("application/json");
                response.getWriter().println(JSON.toJSONString(Map.of(
                    "status", "failure",
                    "message", "下载失败: " + e.getMessage()
                )));
            }
        }
        

        🧠 按月分组聚合逻辑

        private List cutDataListByMonth(List statisticsDataList) {
            LocalDateTime minTime = LocalDateTimeUtil.parse(statisticsDataList.get(0).getStatTime(), DatePattern.PURE_DATE_PATTERN);
            LocalDateTime maxTime = LocalDateTimeUtil.parse(statisticsDataList.get(statisticsDataList.size() - 1).getStatTime(), DatePattern.PURE_DATE_PATTERN);
            Map collect = statisticsDataList.stream()
                .collect(Collectors.groupingBy(s -> s.getStatTime().substring(0, 6)));
            List result = new ArrayList();
            while (!minTime.isAfter(maxTime)) {
                String monthKey = LocalDateTimeUtil.format(minTime, "yyyyMM");
                List monthList = collect.getOrDefault(monthKey, new ArrayList());
                monthList.forEach(s -> s.setStatTime(excelDateFormatter(s.getStatTime())));
                AggregationStatisticsData monthSummary = getAggregationStatisticsData(monthList, "月统计");
                ExcelMonthData data = new ExcelMonthData();
                data.setMonth(minTime.getMonthValue() + "月");
                data.setStatisticsDataList(monthList);
                data.setMonthAggregation(monthSummary);
                result.add(data);
                minTime = minTime.plusMonths(1);
            }
            return result;
        }
        

        ---

        📌 八、总结与建议

        优势	建议
        EasyExcel 写入快、内存占用低	强烈建议使用模板填充，提升开发效率
        支持注解设置样式、美化单元格	可结合注解 + WriteHandler 灵活使用
        模板导出适合企业复杂格式报表	模板和样式提前设计好，开发更轻松

        ---

        如果这篇文章对你有帮助，欢迎点赞 👍、收藏 ⭐、关注我 💬！如有问题可留言交流。