PAYATHON 2026

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 版本及运行环境信息,不能声称示例已经在该项目中验证通过。接入后应检查目标单元格的颜色,以及原有字体、边框、数字格式和其他工作表是否正常。

备注:内容仅供参考。