同一个灰色，POI取出来却是白色：一次Excel颜色解析的踩坑记录

最近在写一个后端转换功能，导入xlsx文件，给他解析成JSON格式。结果测试时发现一个问题：两个看起来一模一样的灰色单元格，代码读出来的颜色不一样。属实给我整懵逼了。
比如下面这两个单元格

• A1：能正常拿到灰值，比如 #808080
  
• B1：拿到的是 FFFFFF —— 白的
  

明明都是手动设置的灰色，样式也一样，拿到的填充颜色确不一样。
我第一反应是前景色/背景色搞混了，于是加了一个判断，前景色拿不到就从背景色拿：

1. XSSFColor color = (XSSFColor) cellStyle.getFillForegroundColorColor();
2. if (color == null) {
3.     color = (XSSFColor) cellStyle.getFillBackgroundColorColor();
4. }

复制代码

最后一试，还是白的。
折腾半天，最后发现关键在于：B1 是个主题色，而 A1 是个普通颜色（换了三个AI，问了半天结合起来才折腾出来）。
主题色是什么？

在 Excel 里用“主题颜色”面板选的颜色，比如“辅助色 3”、“深色 1”这类，都叫主题色。它们不是固定的 RGB 值，而是指向当前工作簿的主题定义。也就是说，换一套主题，这颜色可能就变了。
POI 的 XSSFColor 提供了一个方法判断：

1. color.isThemed() // 返回 true 表示是主题色

复制代码

如果是主题色，直接调 .getRGB() 或 .getARGB() 是拿不到有效值的，经常就是 null 或 FFFFFF。
得结合 ThemesTable 把真正的颜色算出来。
但这还没完。
即使你从 ThemesTable 拿到了主题里的基础颜色，结果可能还是不对。因为还有一个东西叫 tint。
什么是 tint

tint 是 Excel 里用来微调主题颜色明暗的一个参数，取值范围是 -1.0 到 1.0：

• tint = 0：原色
  
• tint > 0：越接近 1，颜色越亮（往白色混合）
  
• tint < 0：越接近 -1，颜色越暗（往黑色混合）
  

比如你选了个“辅助色 3”是深灰，但 Excel 默认给它加了个 tint = -0.24，意思是在这个主题色基础上再压暗一点。如果你忽略这个值，直接拿原始主题色，就会偏亮，甚至变成白色。
所以，只处理主题色不处理 tint，拿到的颜色也可能有问题。
最终解决方案

核心思路：

• 判断是否为 isThemed()
  
• 如果是，从 ThemesTable 中取出对应索引的基础 RGB
  
• 再根据 getTint() 值，对颜色做明暗调整
  

下面是封装好的工具类，可以直接用：

1. import lombok.extern.slf4j.Slf4j;
2. import org.apache.poi.xssf.model.ThemesTable;
3. import org.apache.poi.xssf.usermodel.XSSFColor;
5. import java.awt.*;
7. @Slf4j
8. public class ThemeColorResolver {
10.     /**
11.      * 获取颜色的ARGB十六进制字符串表示
12.      *
13.      * @param themedColor XSSFColor对象
14.      * @param theme       主题表
15.      * @return ARGB格式的十六进制字符串(如 " FFFF0000 " 表示红色)，如果无法解析则返回null
16.      */
17.     public static String getActualColorHex(XSSFColor themedColor, ThemesTable theme) {
18.         Color color = resolveActualColor(themedColor, theme);
19.         return color != null ? toARGBHex(color) : null;
20.     }
22.     /**
23.      * 获取颜色的RGB十六进制字符串表示(不带Alpha通道)
24.      *
25.      * @param themedColor XSSFColor对象
26.      * @param theme       主题表
27.      * @return RGB格式的十六进制字符串(如 " FF0000 " 表示红色)，如果无法解析则返回null
28.      */
29.     public static String getActualColorRGBHex(XSSFColor themedColor, ThemesTable theme) {
30.         Color color = resolveActualColor(themedColor, theme);
31.         return color != null ? toRGBHex(color) : null;
32.     }
34.     /**
35.      * 获取颜色的java.awt.Color对象
36.      *
37.      * @param themedColor XSSFColor对象
38.      * @param theme       主题表
39.      * @return 解析后的Color对象，如果无法解析则返回null
40.      */
41.     public static Color getActualColor(XSSFColor themedColor, ThemesTable theme) {
42.         return resolveActualColor(themedColor, theme);
43.     }
45.     /**
46.      * 核心解析方法
47.      */
48.     private static Color resolveActualColor(XSSFColor themedColor, ThemesTable theme) {
49.         // 如果不是主题色，直接返回ARGB颜色
50.         if (!themedColor.isThemed()) {
51.             byte[] argb = themedColor.getARGB();
52.             if (argb == null || argb.length < 3) {
53.                 log.warn("Non-themed color has invalid ARGB value");
54.                 return null;
55.             }
56.             return new Color(argb[1] & 0xFF, argb[2] & 0xFF, argb[3] & 0xFF, argb[0] & 0xFF);
57.         }
59.         // 解析主题颜色
60.         try {
61.             int themeIndex = themedColor.getTheme();
62.             XSSFColor themeColor = theme.getThemeColor(themeIndex);
63.             byte[] themeRgb = themeColor.getRGB();
65.             if (themeRgb == null || themeRgb.length < 3) {
66.                 log.warn("Theme color not found for index: {}", themeIndex);
67.                 return null;
68.             }
70.             // 获取基础颜色(不考虑tint)
71.             Color baseColor = new Color(themeRgb[0] & 0xFF, themeRgb[1] & 0xFF, themeRgb[2] & 0xFF);
73.             // 应用tint调整
74.             double tint = themedColor.getTint();
75.             if (tint != 0.0) {
76.                 return applyTint(baseColor, tint);
77.             }
79.             return baseColor;
80.         } catch (Exception e) {
81.             log.error("Error resolving theme color", e);
82.             return null;
83.         }
84.     }
86.     /**
87.      * 应用tint值调整颜色
88.      */
89.     private static Color applyTint(Color baseColor, double tint) {
90.         int r = baseColor.getRed();
91.         int g = baseColor.getGreen();
92.         int b = baseColor.getBlue();
94.         if (tint > 0) {
95.             // 变亮（混合白色）
96.             r = (int) (r + (255 - r) * tint);
97.             g = (int) (g + (255 - g) * tint);
98.             b = (int) (b + (255 - b) * tint);
99.         } else if (tint < 0) {
100.             // 变暗（混合黑色）
101.             r = (int) (r * (1 + tint));
102.             g = (int) (g * (1 + tint));
103.             b = (int) (b * (1 + tint));
104.         }
106.         // 确保值在0-255范围内
107.         r = Math.min(255, Math.max(0, r));
108.         g = Math.min(255, Math.max(0, g));
109.         b = Math.min(255, Math.max(0, b));
111.         return new Color(r, g, b);
112.     }
114.     /**
115.      * 将Color转换为ARGB十六进制字符串
116.      */
117.     private static String toARGBHex(Color color) {
118.         return String.format("%02X%02X%02X%02X",
119.                 color.getAlpha(), color.getRed(), color.getGreen(), color.getBlue());
120.     }
122.     /**
123.      * 将Color转换为RGB十六进制字符串(不带Alpha)
124.      */
125.     private static String toRGBHex(Color color) {
126.         return String.format("%02X%02X%02X",
127.                 color.getRed(), color.getGreen(), color.getBlue());
128.     }
129. }

复制代码

使用方式

1. // 获取工作簿的主题表
2. ThemesTable themes = workbook instanceof XSSFWorkbook ? ((XSSFWorkbook) workbook).getThemesTable() : null;
4. // 获取单元格样式颜色
5. XSSFColor fill = (XSSFColor) cellStyle.getFillForegroundColorColor();
6. Color actualColor = ThemeColorResolver.getActualColor(fill, themes);
8. if (actualColor != null) {
9.     String hex = ThemeColorResolver.toHex(actualColor); // 如 #808080
10. }

复制代码

总结

• Excel 的“主题色”不是固定值，不能直接 .getRGB()
  
• isThemed() 是第一步判断
  
• 最终颜色 = 主题基础色 + tint 调整
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！