如何使用Apache POI 4.0.1获取Excel单元格的准确颜色？

我之前也踩过POI处理单元格颜色的坑，结合你的测试结果，帮你梳理一下问题所在和解决办法：

首先要明确一个容易混淆的点：我们平时设置的单元格底色，在POI里属于「填充前景色」（Fill Foreground），而「填充背景色」是配合填充图案使用的（比如条纹、网格图案的背景），这就是你调用getFillBackgroundXSSFColor()返回null的原因——你根本没设置这个值。

分析你遇到的各方法问题： #

• getFillBackgroundXSSFColor().getARGBHex() 返回null：因为你要的颜色不是填充背景色，这个方法拿的是图案背景的颜色，不是单元格底色。
• getFillBackgroundColor() 返回64：这是IndexedColors.AUTOMATIC的默认索引值，说明你没有设置填充背景色，所以返回默认值。
• getFillForegroundColor() 返回0：当单元格使用自定义RGB颜色而非内置索引色时，这个索引值会返回0，所以用它拿不到正确颜色信息。
• getFillForegroundColorColor() 返回XSSFColor对象：这才是正确的对象，只是你需要正确提取它的ARGB值。

正确的获取代码（针对XSSF） #

在POI 4.0.1中，直接调用getARGBHex()可能因为颜色类型（自定义RGB/索引色/主题色）返回null，所以需要分情况处理：

// 先强转成XSSFCellStyle，方便调用XSSF专属方法
XSSFCellStyle cellStyle = (XSSFCellStyle) row.getCell(0).getCellStyle();
XSSFColor fillColor = cellStyle.getFillForegroundColorColor();

if (fillColor != null) {
    // 先尝试获取ARGB字节数组（自定义RGB颜色会返回这个）
    byte[] argbBytes = fillColor.getARGB();
    if (argbBytes != null) {
        // 转换成十六进制字符串，格式为ARGB（比如FF00FF00是绿色）
        String argbHex = String.format("%02X%02X%02X%02X", 
            argbBytes[0], argbBytes[1], argbBytes[2], argbBytes[3]);
        System.out.println("单元格填充颜色ARGB: " + argbHex);
    } else {
        // 如果是内置索引色，通过索引获取对应的RGB
        int colorIndex = cellStyle.getFillForegroundColor();
        IndexedColors indexedColor = IndexedColors.fromInt(colorIndex);
        if (indexedColor != null) {
            byte[] rgbBytes = indexedColor.getTriplet();
            // 索引色默认Alpha为FF（不透明）
            String argbHex = String.format("FF%02X%02X%02X", 
                rgbBytes[0], rgbBytes[1], rgbBytes[2]);
            System.out.println("单元格填充颜色ARGB（索引色）: " + argbHex);
        }
    }
} else {
    System.out.println("单元格没有设置填充颜色");
}

关键注意事项 #

1. 一定要用getFillForegroundColorColor()获取单元格底色对应的Color对象，不要用背景色相关方法。
2. POI 4.0.1中，XSSFColor.getARGBHex()对部分颜色类型支持不好，直接用getARGB()字节数组转换更可靠。
3. 如果是主题色（比如Excel里的「主题颜色」选项），还需要额外处理主题颜色的映射，不过大部分场景下上面的代码足够覆盖自定义RGB和索引色的情况。

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