如何将PrimeNG表格全量数据导出为Excel文件（xlsx）

PrimeNG自带的导出确实只能处理当前页可见数据，要导出全量的话，把逻辑放在后端是最稳妥的——毕竟全量数据本来就存在后端数据库里，直接后端生成Excel再返回给前端下载，既避免了前端拉取大量数据的性能问题，也能保证数据的完整性。下面给你几个亲测好用的Spring后端实现方案：

方案一：Apache POI（最通用的老牌工具） #

Apache POI是Java生态里处理Excel的标准库，支持.xls和.xlsx格式，功能全、文档多，适合大部分常规数据量的场景。

实现步骤： #

1. 引入依赖：在pom.xml中添加POI的核心依赖

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>

2. 编写导出接口：
   • 从数据库查询全量数据（注意如果之前业务用了分页查询，这里要改成不分页的查询逻辑，或者循环拉取所有分页数据）
   • 用POI创建Excel工作簿、工作表，逐行写入表头和数据
   • 通过HttpServletResponse将Excel文件以字节流形式返回，设置响应头触发浏览器自动下载

代码示例： #

@RestController
@RequestMapping("/api/export")
public class ExportController {

    @Autowired
    private YourDataService dataService;

    @GetMapping("/excel")
    public void exportFullDataToExcel(HttpServletResponse response) throws IOException {
        // 1. 获取全量业务数据
        List<YourDataEntity> fullData = dataService.queryAllFullData();

        // 2. 创建Excel工作簿和工作表
        XSSFWorkbook workbook = new XSSFWorkbook();
        XSSFSheet sheet = workbook.createSheet("全量数据清单");

        // 3. 写入表头
        XSSFRow headerRow = sheet.createRow(0);
        String[] headers = {"ID", "业务名称", "创建时间", "状态"};
        for (int i = 0; i < headers.length; i++) {
            XSSFCell cell = headerRow.createCell(i);
            cell.setCellValue(headers[i]);
        }

        // 4. 填充数据行
        int rowIndex = 1;
        for (YourDataEntity data : fullData) {
            XSSFRow dataRow = sheet.createRow(rowIndex++);
            dataRow.createCell(0).setCellValue(data.getId());
            dataRow.createCell(1).setCellValue(data.getBizName());
            dataRow.createCell(2).setCellValue(data.getCreateTime().toString());
            dataRow.createCell(3).setCellValue(data.getStatus());
        }

        // 5. 设置响应头，触发浏览器下载
        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        response.setHeader("Content-Disposition", "attachment; filename=\"full-biz-data.xlsx\"");

        // 6. 将工作簿写入响应流
        OutputStream outputStream = response.getOutputStream();
        workbook.write(outputStream);
        workbook.close();
        outputStream.flush();
    }
}

方案二：EasyExcel（阿里出品，大数据量友好） #

如果你的全量数据量级很大（比如十万条以上），Apache POI一次性加载数据容易出现OOM问题，这时候推荐用阿里的EasyExcel——它采用流式读写机制，内存占用极低，专门解决大数据量导出的性能瓶颈。

实现步骤： #

1. 引入依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.2</version>
</dependency>

2. 编写导出接口：
   • 给数据实体类添加@ExcelProperty注解，指定表头与字段的映射关系
   • 用EasyExcel的流式写入能力，支持分页查询分批写入（无需一次性加载全量数据到内存）

代码示例： #

// 首先定义带Excel注解的实体类

@Data
public class YourDataEntity {
    @ExcelProperty(value = "ID", index = 0)
    private Long id;

    @ExcelProperty(value = "业务名称", index = 1)
    private String bizName;

    @ExcelProperty(value = "创建时间", index = 2)
    private LocalDateTime createTime;

    @ExcelProperty(value = "状态", index = 3)
    private String status;
}

// 控制器导出接口

@GetMapping("/easy-excel")
public void exportWithEasyExcel(HttpServletResponse response) throws IOException {
    // 设置响应头
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    response.setHeader("Content-Disposition", "attachment; filename=\"full-biz-data-easy.xlsx\"");

    // 分页分批写入数据，避免OOM（这里的dataService::queryDataByPage是自定义的分页查询方法）
    EasyExcel.write(response.getOutputStream(), YourDataEntity.class)
            .sheet("全量数据清单")
            .doWrite(() -> dataService.queryDataByPage());
}

前端配合方案 #

在PrimeNG页面中添加自定义导出按钮，点击后调用后端接口即可：

// Angular组件中的导出方法
exportFullData() {
    // 简单场景：直接打开接口URL，浏览器自动下载（适合无需携带token的公开接口）
    window.open('/api/export/excel', '_blank');

    // 带权限验证的场景：用axios处理blob，携带请求头token
    /*
    axios.get('/api/export/excel', { 
        responseType: 'blob',
        headers: { 'Authorization': 'Bearer ' + localStorage.getItem('token') }
    })
    .then(res => {
        const blobUrl = window.URL.createObjectURL(res.data);
        const aTag = document.createElement('a');
        aTag.href = blobUrl;
        aTag.download = 'full-biz-data.xlsx';
        aTag.click();
        window.URL.revokeObjectURL(blobUrl);
    });
    */
}

关键注意事项 #

• 大数据量优化：数据量超过万级时，一定要用分页查询分批写入，或者用JPA的Stream流式查询，避免一次性加载所有数据到内存导致OOM。
• 响应头正确性：务必设置正确的Content-Type和Content-Disposition，否则浏览器可能无法识别为Excel文件，导致下载异常。
• 权限控制：如果接口需要权限验证，要确保请求携带有效token（推荐用axios处理blob的方式，方便设置请求头）。

内容的提问来源于stack exchange，提问作者pmueller