Poiji 4.1.1 下自定义填充色触发 AbstractMethodError,如何绕过?
可以绕过填充色调用,但无法消除依赖冲突
Apache POI 完成 .xlsx 导出后,可以直接修改 ZIP 包中的 xl/styles.xml,为目标单元格样式添加 RGB 填充。这个后处理过程只使用 JDK 的 ZIP 和 XML API,不需要实例化 XSSFColor,也不会调用 StylesTable.putFill() 或 XSSFCellFill.equals()。
前提是现有代码能先成功生成 .xlsx。如果 workbook.write() 或更早的操作已经因为 POI 版本冲突而失败,导出后的修改就无法解决这个问题。
直接操作内存中的 CTFill 也可能绕过某次颜色设置,但需要处理样式共享、填充注册和序列化行为。对于目前无法调整依赖的项目,修改最终文件更容易控制调用范围。
异常发生在颜色比较过程中
堆栈中的调用链是:
XSSFCellStyle.setFillPattern()
-> StylesTable.putFill()
-> XSSFCellFill.equals()
-> XSSFColor.equals()
-> XSSFColor.sameARGB()
-> ExtendedColor.getRGBOrARGB()
-> getStoredRGB()
异常发生在填充样式的比较过程中。更换 XSSFColor 的构造方式仍会进入相同的颜色比较路径,因此 ARGB hex、java.awt.Color 和 byte array 都可能遇到同一个错误。
AbstractMethodError 表明运行时加载的类之间存在二进制不兼容。仅凭这个异常,无法认定冲突一定来自 Poiji 内嵌的 JAR,也无法认定实例化 XSSFColor 本身就会失败。
可以先查看两个类的实际来源,这不会修改依赖配置:
System.out.println(
org.apache.poi.xssf.usermodel.XSSFColor.class
.getProtectionDomain().getCodeSource());
System.out.println(
org.apache.poi.ss.usermodel.ExtendedColor.class
.getProtectionDomain().getCodeSource());
再结合依赖树检查版本:
mvn dependency:tree -Dincludes=org.apache.poi
检查时需要区分 Maven 传递依赖和直接打包在其他 JAR 内的同名类。exclusions 只能排除传递依赖,无法删除已经嵌入某个 JAR 的 class 文件。目前的信息不足以确认项目属于哪一种情况。
在最终 styles.xml 中添加填充
普通 .xlsx 文件中的填充和单元格样式通过以下关系关联:
fills保存填充定义,fillId是其中从 0 开始的索引。cellXfs保存单元格样式,每个xf可以引用一个fillId。- 工作表单元格的
s属性引用cellXfs中的样式索引。
可以追加一个填充定义,再修改目标样式的 fillId,无需改动工作表里的单元格引用。
目标填充的 XML 内容为:
<fill xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
<patternFill patternType="solid">
<fgColor rgb="FF00458D"/>
<bgColor indexed="64"/>
</patternFill>
</fill>
FF00458D 使用八位 ARGB 表示,其中 FF 是 alpha 部分。当 patternType="solid" 时,显示的填充色由 fgColor 指定。
后处理代码
下面的示例适用于普通、未加密的 .xlsx 文件,使用 Java 9+ 的 InputStream.readAllBytes()。代码在内存中处理整个文件,适合文件大小可控的导出场景。
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;
import java.util.zip.ZipOutputStream;
import javax.xml.XMLConstants;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
public final class XlsxFillPatch {
private static final String NS =
"http://schemas.openxmlformats.org/spreadsheetml/2006/main";
private XlsxFillPatch() {
}
public static byte[] apply(byte[] xlsx, int styleIndex)
throws Exception {
ByteArrayOutputStream result = new ByteArrayOutputStream();
boolean foundStyles = false;
try (ZipInputStream input = new ZipInputStream(
new ByteArrayInputStream(xlsx));
ZipOutputStream output = new ZipOutputStream(result)) {
ZipEntry entry;
while ((entry = input.getNextEntry()) != null) {
byte[] data = input.readAllBytes();
if ("xl/styles.xml".equals(entry.getName())) {
data = patchStyles(data, styleIndex);
foundStyles = true;
}
output.putNextEntry(new ZipEntry(entry.getName()));
output.write(data);
output.closeEntry();
input.closeEntry();
}
}
if (!foundStyles) {
throw new IllegalArgumentException(
"xl/styles.xml was not found");
}
return result.toByteArray();
}
private static byte[] patchStyles(byte[] xml, int styleIndex)
throws Exception {
DocumentBuilderFactory factory =
DocumentBuilderFactory.newInstance();
factory.setNamespaceAware(true);
factory.setFeature(
"http://apache.org/xml/features/disallow-doctype-decl",
true);
factory.setAttribute(XMLConstants.ACCESS_EXTERNAL_DTD, "");
factory.setAttribute(XMLConstants.ACCESS_EXTERNAL_SCHEMA, "");
Document document = factory.newDocumentBuilder().parse(
new ByteArrayInputStream(xml));
Element root = document.getDocumentElement();
Element fills = child(root, "fills");
Element cellXfs = child(root, "cellXfs");
if (fills == null || cellXfs == null) {
throw new IllegalArgumentException(
"Expected fills and cellXfs in styles.xml");
}
NodeList styles = cellXfs.getElementsByTagNameNS(NS, "xf");
if (styleIndex < 0 || styleIndex >= styles.getLength()) {
throw new IllegalArgumentException(
"Invalid style index: " + styleIndex);
}
int fillId = fills.getElementsByTagNameNS(NS, "fill")
.getLength();
Element fill = document.createElementNS(NS, "fill");
Element pattern = document.createElementNS(NS, "patternFill");
pattern.setAttribute("patternType", "solid");
Element foreground = document.createElementNS(NS, "fgColor");
foreground.setAttribute("rgb", "FF00458D");
pattern.appendChild(foreground);
Element background = document.createElementNS(NS, "bgColor");
background.setAttribute("indexed", "64");
pattern.appendChild(background);
fill.appendChild(pattern);
fills.appendChild(fill);
fills.setAttribute("count", Integer.toString(fillId + 1));
Element xf = (Element) styles.item(styleIndex);
xf.setAttribute("fillId", Integer.toString(fillId));
xf.setAttribute("applyFill", "1");
TransformerFactory transformers =
TransformerFactory.newInstance();
transformers.setAttribute(XMLConstants.ACCESS_EXTERNAL_DTD, "");
transformers.setAttribute(
XMLConstants.ACCESS_EXTERNAL_STYLESHEET, "");
ByteArrayOutputStream result = new ByteArrayOutputStream();
transformers.newTransformer().transform(
new DOMSource(document), new StreamResult(result));
return result.toByteArray();
}
private static Element child(Element parent, String localName) {
for (Node node = parent.getFirstChild();
node != null;
node = node.getNextSibling()) {
if (node instanceof Element
&& NS.equals(node.getNamespaceURI())
&& localName.equals(node.getLocalName())) {
return (Element) node;
}
}
return null;
}
}
代码会追加一个新的 fill,并修改指定的 cellXfs/xf。它会保留该样式原有的字体、边框、数字格式和其他属性,也不会覆盖其他样式共同引用的旧填充。
接入现有导出流程
先为需要该颜色的表头创建一个专用样式,复制现有表头格式,再将这个样式分配给目标单元格。此时无需调用 RGB 颜色相关的 setter。
// workbook、headerStyle、headerCell 是现有导出流程中的对象。
XSSFCellStyle rgbHeaderStyle = workbook.createCellStyle();
rgbHeaderStyle.cloneStyleFrom(headerStyle);
headerCell.setCellStyle(rgbHeaderStyle);
// 如果有多个目标表头,将同一个 rgbHeaderStyle 分配给它们。
int styleIndex = rgbHeaderStyle.getIndex() & 0xFFFF;
ByteArrayOutputStream buffer = new ByteArrayOutputStream();
workbook.write(buffer);
byte[] result = XlsxFillPatch.apply(buffer.toByteArray(), styleIndex);
java.nio.file.Files.write(
java.nio.file.Paths.get("report.xlsx"), result);
这里的 & 0xFFFF 用于处理部分 POI 版本中 getIndex() 返回的 short。传入的索引必须来自同一个 workbook。
直接修改原有表头样式对应的 xf,会影响所有使用该样式的单元格。创建专用样式可以将修改范围限定在目标表头上。
为什么不直接修改 CTStylesheet
XSSFWorkbook 的样式既涉及 XMLBeans 对象,也涉及 StylesTable 管理的填充集合。仅向 getCTStylesheet() 返回的对象中追加一个 CTFill,不能直接认定它已经完成 POI 内部的填充注册。写出时的行为还取决于实际加载版本的实现。
调用 StylesTable.putFill() 注册可能再次进入堆栈中的比较路径;直接修改已有填充对应的 CTFill,又可能同时影响所有引用该填充的样式。
在确认运行时版本和内部行为之前,不宜把单纯追加 CTFill 当作稳定的通用方案。导出后修改 ZIP 中的 XML,可以避开这部分 POI 内部状态管理。
使用时需要注意什么
后处理必须放在所有 POI 操作完成之后。修改后的字节应直接保存或发送;如果重新用当前存在版本冲突的 POI 加载并操作文件,仍可能触发异常。
这段代码只保证后处理过程不创建 XSSFColor。工作簿生成阶段是否在其他地方创建颜色对象,是否存在其他不兼容调用,需要结合现有流程确认。
代码没有保留 ZIP 条目的原始压缩方式、时间等元数据,也不适用于需要保留有效数字签名的文件。对于大型导出,应改为使用临时文件或流式复制,避免整个 .xlsx 同时驻留内存。
由于缺少项目实际加载的 POI、XMLBeans 版本及运行环境信息,不能声称示例已经在该项目中验证通过。接入后应检查目标单元格的颜色,以及原有字体、边框、数字格式和其他工作表是否正常。
备注:内容仅供参考。
