Apache POI数据透视表列排序失效问题求助

我使用Apache POI生成数据透视表，生成完成后希望将显示月份数据的列按时间升序排序，但尝试的排序代码均未生效。

生成数据透视表的示例代码 #

XSSFSheet dataSheet
        = workbook.createSheet("DataSheet");
workbook = dataWriteService.writeToSheet(workbook, dataSheet, dataResponseList); // 数据写入工作表
XSSFSheet sheet = workbook.createSheet("PIVOTSHEET");

AreaReference ar = new AreaReference(topLeft, botRight, SpreadsheetVersion.EXCEL2007);
CellReference cr1 = new CellReference("A1");
XSSFPivotTable pivotTable1 = sheet.createPivotTable(ar, cr1, dataSheet);
pivotTable1.addRowLabel(5);
pivotTable1.addRowLabel(12);
pivotTable1.addColLabel(19);
final File xlsFile = new File("dataWithPivot.xlsm");
FileOutputStream fileOutputStream = new FileOutputStream(xlsFile);
workbook.write(fileOutputStream);

尝试过的无效排序代码 #

int indexOfSortColumn = 1;
pivotTable.getCTPivotTableDefinition()
        .getPivotFields()
        .getPivotFieldArray(indexOfSortColumn)
        .setSortType(STFieldSortType.ASCENDING);
// 第二种尝试方法也无效
CTPivotField fld = pivotTable1.getCTPivotTableDefinition().getPivotFields().getPivotFieldList().get(1);
fld.setSortType(STFieldSortType.ASCENDING);

build.gradle配置 #

implementation group: 'org.apache.poi', name: 'poi-ooxml-full', version: '5.2.2'
implementation group: 'org.apache.poi', name: 'ooxml-schemas', version: '1.1'

解决方案 #

仅设置PivotField的sortType不足以生效，需要结合排序依据、字段轴属性，同时确保索引对应正确。以下是可行的实现步骤：

1. 确认正确的字段索引：你通过addColLabel(19)添加了月份列作为列标签，这个19是数据源中月份列的索引，因此透视字段数组中对应的索引也是19（之前错误使用了索引1，这是排序失效的核心原因）。
2. 完整配置排序属性：除了排序类型，还需指定排序依据、字段轴类型，并启用自动排序。

修改后的有效排序代码：

// 数据源中月份列的索引，对应addColLabel(19)的参数
int monthColIndexInSource = 19;
CTPivotField pivotField = pivotTable1.getCTPivotTableDefinition().getPivotFields().getPivotFieldArray(monthColIndexInSource);

// 设置排序类型为升序
pivotField.setSortType(STFieldSortType.ASCENDING);
// 指定按字段自身值排序
pivotField.setSortBy(STSortBy.VALUE);
// 标记该字段为列轴字段
pivotField.setAxis(STAxis.COLUMN);
// 启用自动排序
pivotField.setAutoSort(true);

// 补充设置列字段的排序方向
CTPivotTableDefinition pivotDef = pivotTable1.getCTPivotTableDefinition();
if (pivotDef.getColFields() != null && pivotDef.getColFields().getFieldCount() > 0) {
    pivotDef.getColFields().getFieldArray(0).setAscending(true);
}

关键说明 #

• 透视字段的索引必须与数据源中目标列的索引严格对应，不能随意指定索引值。
• 仅设置sortType无法触发排序，必须配合sortBy、axis、autoSort等属性完成完整配置。
• 最后补充列字段的排序方向设置，确保Excel读取时识别排序规则。

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