Java如何读取Excel图片？java poi读取excel图片

在Java中读取Excel图片，核心方案是使用Apache POI库解析XLSX文件，通过遍历XML关系文件定位图片流并转换为Base64或字节数组，无需依赖第三方商业软件即可实现高效提取。

很多开发者在接到“从Excel中提取图片”的需求时，第一反应往往是寻找现成的工具类或购买昂贵的商业组件，对于大多数常规业务场景，开源的Apache POI配合底层XML解析已经足够应对，Excel文件（特别是.xlsx格式）本质上是一个ZIP压缩包，内部存储着结构化的XML数据，图片并非直接嵌入在单元格中，而是作为独立的媒体资源存储在特定的文件夹中，并通过关系文件（Relationships）与单元格建立关联，理解这一底层逻辑，是编写稳定代码的前提。

加载中

java Web项目 POI导入excel带图片的数据。SpringBoot导入excel图片，SSM项目导入excel带图片的数据

程序员陈豪

39079-

原视频地址

技术选型与核心依赖配置

在开始编码之前,选择合适的库至关重要，业内专家指出，Apache POI是目前Java生态中处理Office文档的事实标准，尽管其内存占用较高，但兼容性和稳定性经过了多年的市场验证。

依赖引入与环境准备

你需要在项目的pom.xml文件中引入以下核心依赖，建议使用较新的版本以获取更好的性能优化和Bug修复。

• poi-ooxml：这是核心包，包含了处理XLSX格式所需的所有类，注意，不要单独引入poi，必须引入ooxml变体以支持XML解析。
• dom4j：POI内部依赖此库进行XML解析，确保版本兼容，避免冲突。
• commons-io：用于简化文件流的读写操作，提升代码整洁度。

版本兼容性提示

不同版本的POI对JDK版本有要求,POI 5.x版本通常要求JDK 8或更高，如果你的项目运行在老旧环境中，可能需要回退到POI 4.x系列，处理大型Excel文件时，务必开启POI的SXSSF模式或使用事件模型，否则极易触发OutOfMemoryError。

底层原理：Excel图片存储机制解析

要精准提取图片,必须理解.xlsx文件的内部结构，这与.xls（二进制格式）有本质区别。

ZIP结构拆解

当你将.xlsx文件后缀改为.zip并解压后，会看到以下关键目录：

• xl/media/：这里存放了所有嵌入的图片文件，如image1.png, image2.jpeg等。
• xl/worksheets/sheet1.xml：存储单元格数据及绘图对象的引用ID。

• 

  xl/_rels/sheet1.xml.rels：关系文件，定义了绘图对象ID与media目录下具体图片文件的对应关系。

数据流向逻辑

整个提取过程可以概括为三个步骤：

1. 定位绘图对象：在sheet XML中查找<drawing>标签，获取其关联的r:id（关系ID）。
2. 解析关系映射：读取对应的.rels文件，根据r:id找到media目录下的具体文件名。
3. 读取二进制流：从解压后的media目录中读取该文件字节流，完成提取。

实战代码：Java读取Excel图片完整流程

以下代码展示了如何从XLSX文件中提取图片并保存为本地文件,该方案适用于中小规模数据，若需处理百万行级数据，建议结合流式API进行优化。

核心工具类实现

import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.apache.poi.ss.usermodel.Workbook;
import java.io.;
import java.util.HashMap;
import java.util.Map;
public class ExcelImageExtractor {
    public static void extractImages(String filePath, String outputDir) throws Exception {
        // 1. 加载工作簿
        try (FileInputStream fis = new FileInputStream(filePath);
             Workbook workbook = new XSSFWorkbook(fis)) {
            // 2. 遍历所有Sheet
            for (int i = 0; i < workbook.getNumberOfSheets(); i++) {
                XSSFSheet sheet = (XSSFSheet) workbook.getSheetAt(i);
                // 3. 获取绘图列表
                List<XSSFDrawing> drawings = sheet.getDrawings();
                for (XSSFDrawing drawing : drawings) {
                    List<XSSFShape> shapes = drawing.getShapes();
                    for (XSSFShape shape : shapes) {
                        if (shape instanceof XSSFPicture) {
                            XSSFPicture picture = (XSSFPicture) shape;
                            XSSFClientAnchor anchor = picture.getClientAnchor();
                            // 4. 获取图片数据
                            PictureData pictureData = picture.getPictureData();
                            byte[] data = pictureData.getData();
                            String extension = pictureData.suggestFileExtension();
                            // 5. 保存文件
                            String fileName = "image_" + System.currentTi
meMillis() + "." + extension;
                            File outputFile = new File(outputDir, fileName);
                            try (FileOutputStream fos = new FileOutputStream(outputFile)) {
                                fos.write(data);
                            }
                            System.out.println("成功提取图片: " + fileName);
                        }
                    }
                }
            }
        }
    }
}

关键步骤解析

• Workbook初始化：使用try-with-resources确保流正确关闭，防止文件句柄泄露。
• 遍历Sheet：部分Excel文件可能包含多个Sheet，每个Sheet可能包含独立的绘图对象，因此必须全量遍历。
• Shape类型判断：并非所有绘图对象都是图片，可能是图表或形状，因此需通过`instanceof XSSFPicture`进行严格过滤。
• 后缀建议：`suggestFileExtension()`方法能自动识别图片格式（如png, jpg），避免手动判断带来的错误。

常见问题与性能优化策略

在处理实际项目时,开发者常遇到内存溢出或图片提取不全的问题，以下是基于行业共识的解决方案。

内存溢出（OOM）应对方案

当Excel文件超过10MB或行数超过5万行时,传统POI模式极易导致JVM崩溃。

使用SXSSF流式写入/读取

虽然SXSSF主要用于写入,但配合POI的事件模型（Event API）可以实现低内存读取，事件模型对图片的支持较弱，通常建议将大文件拆分为多个小文件处理，或使用专门的流式解析库如EasyExcel（需注意EasyExcel对图片的支持版本迭代情况）。

增加JVM堆内存

对于短期任务,最直接的方法是调整启动参数：-Xmx4g -Xms2g，这能临时缓解内存压力，但治标不治本。

图片提取不全或乱码

有时提取出的图片无法打开,或文件名包含特殊字符。

• 编码问题：确保文件读写时使用UTF-8编码，特别是在处理中文路径时。
• 格式兼容：部分老旧Excel文件可能包含非标准图片格式，建议在保存前添加简单的格式校验，如检查文件头Magic Number。

不同场景下的技术选型对比

为了帮助开发者做出更合适的选择,我们对比几种主流方案。

据工信部相关技术白皮书显示,在金融和电商行业的数据处理中，超过半数的企业仍首选Apache POI作为底层引擎，因其稳定性和对复杂格式的支持能力无可替代。

总结与建议

Java读取Excel图片并非黑盒操作,只要理清XML关系映射逻辑，即可通过POI轻松实现，对于常规业务，上述代码片段可直接复用，若面临超大数据量挑战，建议重构数据架构，避免在Excel中嵌入大量图片，或采用数据库存储图片、Excel仅存链接的架构模式。

Q&A：Java读取Excel图片常见问题

Java读取Excel图片支持.xls格式吗？

支持,但难度较大。.xls是二进制格式，图片存储结构复杂且缺乏统一标准，POI的HSSF模块对.xls图片的支持不完善，通常建议将.xls转换为.xlsx后再处理，或使用商业库如Aspose.Cells。

提取的图片为什么是损坏的？

通常是因为字节流读取不完整或编码错误,请检查FileInputStream是否完全读取了数据，并确保保存时未对字节数组进行额外的字符串转换，部分Excel文件中的图片可能是矢量图（WMF/EMF），直接保存为PNG可能导致显示异常，需根据后缀名选择正确的解码器。

如何获取图片在Excel中的位置坐标？

通过XSSFClientAnchor对象可以获取图片的锚点信息,该对象包含起始和结束的行列号及偏移量。anchor.getRow1()返回起始行，anchor.getCol1()返回起始列，结合这些信息，可以在前端或后端重建图片的布局位置。