You need to enable JavaScript to run this app. Java中如何提取Excel指定工作表并转换为byte[]格式返回
优惠活动
大模型
产品
解决方案
定价
更多

Java中如何提取Excel指定工作表并转换为byte[]格式返回

核心实现逻辑

  • 无法直接将单个Sheet对象转为字节数组,需先创建一个全新的空工作簿,把目标工作表完整复制到新工作簿中
  • 将新工作簿写入字节输出流,最终转换为byte[]返回
  • 需额外补充页码合法性校验、资源自动关闭逻辑,避免参数越界和内存泄漏

完整服务层代码

public byte[] getExcelByPageNumber(Integer pageNumber) throws IOException {
    // 注意:如果前端传入的页码是从1开始计数,需要先执行 pageNumber = pageNumber - 1
    try (
        // 读取原始工作簿
        Workbook originWorkbook = WorkbookFactory.create(loader.getResource("classpath:file.xls").getInputStream());
        // 创建新的空工作簿
        Workbook newWorkbook = WorkbookFactory.create(true);
        // 字节输出流存储新工作簿内容
        ByteArrayOutputStream baos = new ByteArrayOutputStream()
    ) {
        // 校验页码合法性
        int maxPage = originWorkbook.getNumberOfSheets() - 1;
        if (pageNumber < 0 || pageNumber > maxPage) {
            throw new IllegalArgumentException("页码非法,有效范围为 0-" + maxPage);
        }
        // 读取原始目标工作表
        Sheet originSheet = originWorkbook.getSheetAt(pageNumber);
        // 在新工作簿创建同名工作表
        Sheet newSheet = newWorkbook.createSheet(originSheet.getSheetName());
        // 完整复制工作表内容、样式、格式
        SheetCopier copier = originSheet.createSheetCopier(newSheet);
        copier.copySheet();
        // 将新工作簿写入字节流
        newWorkbook.write(baos);
        return baos.toByteArray();
    }
}

控制器优化(适配前端下载场景)

如果需要支持前端直接下载文件,可以补充响应头配置:

@GetMapping(value = "/getSinglePage/{pageNumber}")
private ResponseEntity<byte[]> getExcelByPageNumber(@PathVariable Integer pageNumber) throws IOException {
    byte[] excelBytes = service.getExcelByPageNumber(pageNumber);
    HttpHeaders headers = new HttpHeaders();
    // 设置响应类型为二进制流
    headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
    // 设置下载文件名
    headers.setContentDispositionFormData("attachment", "第" + pageNumber + "页.xls");
    return new ResponseEntity<>(excelBytes, headers, HttpStatus.OK);
}

注意事项

  • Apache POI默认工作表页码从0开始计数,如果业务里页码从1开始,需在使用前对pageNumber做减1处理
  • 代码同时兼容.xls和.xlsx格式,WorkbookFactory会自动匹配对应类型的工作簿实现
  • 建议使用POI 4.1.2及以上稳定版本,避免版本兼容问题

内容的提问来源于stack exchange,提问作者Bhumika

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 03:36:08