java中Excel导出图片导致内存溢出

### 使用Java和EasyExcel库导出包含图片的Excel表格 在Web开发中，经常会有导出带有复杂数据结构（如图片）的Excel需求。阿里云推出的EasyExcel是一个轻量级、高效的工具，专门用于处理大规模Excel文件而不会造成内存溢出问题[^2]。 为了实现出带图片的Excel文档，在编写代码前需引入必要的依赖项： ```xml <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>最新版本号</version> </dependency> ``` 下面展示一段简单的例子来说明如何利用EasyExcel向单元格内插入图像资源并保存至指定路径下的xlsx文件中: #### 创建实体类ImageModel.java定义表头以及存储位置字段 ```java import com.alibaba.excel.annotation.ExcelProperty; import lombok.Data; @Data public class ImageModel { @ExcelProperty("描述") private String description; // 图片地址, 可以为本地绝对路径或网络URL private String imagePath; } ``` #### 编写服务层逻辑ExportService.java完成实际的数据组装与导出功能 ```java import cn.hutool.core.io.FileUtil; import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.streaming.SXSSFWorkbook; import javax.imageio.ImageIO; import java.awt.image.BufferedImage; import java.io.ByteArrayOutputStream; import java.io.FileOutputStream; import java.util.List; public void exportImagesToExcel(List<ImageModel> imageModels, String outputPath){ SXSSFWorkbook workbook = new SXSSFWorkbook(); Sheet sheet = workbook.createSheet(); int rowIndex = 0; Row row = null; Cell cell = null; Drawing<?> patriarch = sheet.createDrawingPatriarch(); CreationHelper helper = workbook.getCreationHelper(); for (int i=0;i<imageModels.size();++i){ ImageModel model=imageModels.get(i); try{ BufferedImage img = ImageIO.read(new File(model.getImagePath())); ByteArrayOutputStream byteArrayOut = new ByteArrayOutputStream(); ImageIO.write(img,"png",byteArrayOut); byte[] bytes = byteArrayOut.toByteArray(); Patriarch drawing = sheet.createDrawingPatriarch(); ClientAnchor anchor = helper.createClientAnchor(); anchor.setCol1(1); // 列索引从0开始计算 anchor.setRow1(rowIndex++ +1 );// 行索引同样如此 Picture pict = drawing.createPicture(anchor,new XSSFClientAnchor().createPicture(bytes)); pict.resize();// 自动调整大小适应单元格宽度高度比例 row=sheet.createRow(++rowIndex); cell=row.createCell(0); cell.setCellValue(model.getDescription()); }catch(Exception e){ log.error(e.getMessage(),e); } } FileOutputStream fileOut=null; try{ fileOut=new FileOutputStream(outputPath); workbook.write(fileOut); }finally{ if(workbook!=null)workbook.close(); if(fileOut !=null )fileOut.close(); } } ``` 上述方法接收`List<ImageModel>`作为参数列表，其中包含了每张待嵌入图片的相关信息；同时接受目标输出路径字符串。遍历输入集合中的每一个元素，依次创建新的行对象，并在其基础上构建绘图容器以容纳位图形式的内容。最后将整个工作簿序列化成字节流的形式写出到磁盘上形成最终产物。 值得注意的是，这里采用了SXSSFWorkbook代替传统的XSSFWorkbook，前者专为解决大容量场景下性能瓶颈设计而成，有效降低了JVM堆空间占用率，提高了程序运行效率。

要使用 EasyPoi 库实现 Excel 导出并嵌入图片，可以通过以下步骤进行操作： ### 实体类定义 在实体类中，需要定义一个 `byte[]` 类型的字段来存储图片数据，并使用 `@Excel` 注解来指定该字段在 Excel 中的表现形式。例如，可以设置图片的宽度、高度以及图片类型等属性。 ```java import cn.afterturn.easypoi.excel.annotation.Excel; public class Talen { @Excel(name = "签收单号", width = 30) private String signingRemark; @Excel(name = "签收单", width = 40, type = 2, height = 20, imageType = 2) private byte[] uploadSignPhotos; @Excel(name = "备注", width = 30) private String remark; // Getters and Setters } ``` ### 导出逻辑 在导出逻辑中，首先创建 `ExportParams` 对象并设置 sheet 名称。然后使用 `ExcelExportUtil.exportExcel` 方法将数据导出为 Excel 文件。为了确保图片能够正确显示，还需要手动调整行高。 ```java import cn.afterturn.easypoi.excel.entity.ExportParams; import cn.afterturn.easypoi.excel.util.ExcelExportUtil; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.ss.usermodel.Sheet; import java.io.OutputStream; import java.util.ArrayList; import java.util.List; public class ExcelExporter { public void exportExcelWithImages() { List<Talen> list = new ArrayList<>(); // 填充 list 数据 ExportParams params = new ExportParams(); params.setSheetName("sheet1"); int listCount = 0; if (!list.isEmpty()) { listCount = list.size(); } Workbook workbook = ExcelExportUtil.exportExcel(params, Talen.class, list); if (listCount > 0) { Sheet sheet0 = workbook.getSheet("sheet1"); for (int i = 1; i < listCount + 1; i++) { sheet0.getRow(i).setHeight((short) 2000); } } try { // 设置响应头和输出流 WebUtil.setResponseFile("测试.xlsx"); WebUtil.getResponse().setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE); OutputStream outputStream = WebUtil.getResponse().getOutputStream(); workbook.write(outputStream); } catch (Exception e) { throw new BaseException("导出excel失败", e); } finally { try { workbook.close(); } catch (Exception e) { // 处理异常 } } } } ``` ### 注意事项 - **图片数据获取**：确保从数据库或网络（如阿里云 OSS）获取的图片 URL 能够被转换为 `byte[]` 格式。 - **图片大小**：根据需求合理设置单元格的宽度和高度，以保证图片在 Excel 中显示正常。 - **性能优化**：如果导出的数据量较大，建议对代码进行性能优化，避免内存溢出。 通过以上步骤，可以成功使用 EasyPoi 库实现 Excel 导出并嵌入图片的功能[^2]。