使用Apache POI生成数据透视表，如何支持单元格超过255字符？

问题根源 #

Excel的OOXML规范中，数据透视表缓存（PivotCache）里的<s>元素的v属性仅支持最多255个字符的字符串。当直接用setV(item)存储超过255字符的文本时，会导致缓存文件不符合规范，Excel打开时会触发修复提示。

解决方案 #

修改代码中向缓存字段添加共享项的逻辑：判断字符串长度，超过255字符时改用**内联字符串（<is>元素）**存储，而非<s v="...">格式。

修改后的代码片段 #

替换原代码中添加共享项的逻辑，改为以下实现：

int i = 0;
CTCacheFields.CTCacheField cacheField = pivotTable.getPivotCacheDefinition().getCTPivotCacheDefinition().getCacheFields()
        .getCacheFieldArray(column);
CTSharedItems sharedItems = cacheField.getSharedItems();
for (String item : uniqueItems) {
    // 处理PivotField的item编号
    ctPivotField.getItems().getItemArray(i).unsetT();
    ctPivotField.getItems().getItemArray(i).setX((long) i);
    
    // 根据字符串长度选择存储方式
    if (item.length() > 255) {
        // 长文本使用内联字符串
        CTInlineString inlineStr = sharedItems.addNewIs();
        inlineStr.addNewT().setStringValue(item);
    } else {
        // 短文本保留原有方式
        sharedItems.addNewS().setV(item);
    }
    i++;
}

补充说明 #

• 内联字符串（<is>）是Excel OOXML规范中专门用于存储长文本的格式，无255字符限制。
• 短文本仍使用<s v="...">格式，避免不必要的性能开销。

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