无法读取.xlsx单元格RGB数据，求获取单元格颜色的有效方案

看起来你在读取.xlsx单元格颜色时踩了几个常见的POI API坑，我来帮你梳理清楚问题所在并给出可行的解决方案：

为什么你的之前的代码都不对？ #

先解释下核心误区：

• 混淆了填充前景色和背景色：Excel单元格的实际填充色是由填充前景色（Fill Foreground）决定的，填充背景色只有在使用非纯色图案（比如条纹、网格）时才会生效。你之前一直用getFillBackgroundXSSFColor，自然拿不到正确的颜色值。
• 索引色 vs 自定义RGB色：Excel的颜色分两种，一种是内置的索引色（Indexed Colors），另一种是自定义RGB色。直接操作CTColor的DOM节点容易出现NPE，因为索引色不会存储rgb属性；而getARGBHex()对索引色也会返回null。
• getFillBackgroundColor()返回64是正常的：这个方法返回的是默认填充背景色的索引（64对应白色），和单元格实际显示的填充色完全无关。

正确的代码实现 #

下面是针对.xlsx文件的完整代码，能正确获取单元格填充色并判断是否为红、黄、绿：

import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.CellStyle;
import org.apache.poi.xssf.usermodel.XSSFCellStyle;
import org.apache.poi.xssf.usermodel.XSSFColor;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileInputStream;
import java.io.IOException;

public class ExcelCellColorChecker {
    public static void main(String[] args) throws IOException {
        // 替换成你的文件路径
        try (XSSFWorkbook workbook = new XSSFWorkbook(new FileInputStream("your-file.xlsx"))) {
            var targetSheet = workbook.getSheetAt(0); // 读取第一个工作表

            for (var row : targetSheet) {
                for (Cell currentCell : row) {
                    int rowIdx = currentCell.getRowIndex();
                    int colIdx = currentCell.getColumnIndex();
                    CellStyle cellStyle = currentCell.getCellStyle();
                    XSSFCellStyle xssfStyle = (XSSFCellStyle) cellStyle;

                    // 关键：获取填充前景色，这才是单元格显示的颜色
                    XSSFColor fillColor = xssfStyle.getFillForegroundXSSFColor();

                    if (fillColor != null) {
                        String argbHex = fillColor.getARGBHex();
                        if (argbHex != null) {
                            // 去掉前两位Alpha通道值，得到纯RGB
                            String rgbHex = argbHex.substring(2).toLowerCase();
                            System.out.printf("行: %d, 列: %d, RGB值: #%s%n", rowIdx, colIdx, rgbHex);
                            checkColorType(rgbHex);
                        } else {
                            // 处理索引色：从工作簿调色板中获取对应RGB
                            short colorIndex = xssfStyle.getFillForegroundColor();
                            System.out.printf("行: %d, 列: %d, 索引色编号: %d%n", rowIdx, colIdx, colorIndex);
                            XSSFColor indexedColor = workbook.getCustomPalette().getColor(colorIndex);
                            if (indexedColor != null) {
                                String indexedRgb = indexedColor.getARGBHex().substring(2).toLowerCase();
                                System.out.printf("  对应RGB值: #%s%n", indexedRgb);
                                checkColorType(indexedRgb);
                            }
                        }
                    } else {
                        System.out.printf("行: %d, 列: %d, 无填充色%n", rowIdx, colIdx);
                    }
                }
            }
        }
    }

    // 判断是否为红、黄、绿
    private static void checkColorType(String rgbHex) {
        switch (rgbHex) {
            case "ff0000":
                System.out.println("  颜色类型：红色");
                break;
            case "ffff00":
                System.out.println("  颜色类型：黄色");
                break;
            case "00ff00":
                System.out.println("  颜色类型：绿色");
                break;
            default:
                System.out.println("  颜色类型：非红/黄/绿");
        }
    }
}

额外注意事项 #

1. 针对.xls文件的适配：如果你需要处理旧版.xls文件，需要把XSSF相关类替换成HSSF类（比如HSSFWorkbook、HSSFCellStyle），索引色的处理逻辑类似。
2. 主题色的处理：如果单元格用的是Excel主题色（比如"主题色1"），getARGBHex()会返回null，这时候需要通过fillColor.getTheme()和fillColor.getTint()计算实际RGB值，不过针对红黄绿这类基础色，一般用索引色或自定义RGB就足够覆盖。
3. 空单元格处理：如果遇到空单元格，确保先判断单元格是否为null，避免空指针异常。

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