Apache POI设置Excel图表为「不随单元格移动或调整大小」报错解决

问题原因 #

你遇到的空指针异常是因为在XSSF（.xlsx格式）的图表操作中，getGraphicFrame()方法已不再适用——新版POI采用XDDF架构处理XSSF图表，该方法会返回null。而你之前的代码逻辑是针对旧版HSSF（.xls格式）的图表设计的，两者API差异较大。

解决方案 #

根据你使用的Excel格式（.xlsx或.xls），选择对应的代码实现：

1. 处理XSSF（.xlsx）文件

通过直接操作底层XML Bean来设置锚点类型：

import org.apache.poi.xssf.usermodel.XSSFChart;
import org.apache.poi.xssf.usermodel.XSSFDrawing;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.openxmlformats.schemas.drawingml.x2006.chart.CTChartSpace;
import org.openxmlformats.schemas.drawingml.x2006.spreadsheetDrawing.CTTwoCellAnchor;
import org.openxmlformats.schemas.drawingml.x2006.spreadsheetDrawing.STEditAs;

// 假设dbSheet是你的XSSFSheet实例
XSSFDrawing drawing = (XSSFDrawing) dbSheet.getDrawingPatriarch();
if (drawing != null) {
    for (XSSFChart chart : drawing.getCharts()) {
        CTChartSpace chartSpace = chart.getCTChartSpace();
        // 多数情况下图表使用双单元格锚点，需根据实际类型调整
        if (chartSpace.getAnchor() instanceof CTTwoCellAnchor) {
            CTTwoCellAnchor anchor = (CTTwoCellAnchor) chartSpace.getAnchor();
            // 设置为「不随单元格移动或调整大小」
            anchor.setEditAs(STEditAs.DONT_MOVE_AND_RESIZE);
        }
    }
}

2. 处理HSSF（.xls）文件

如果是旧版.xls格式，可以保留原逻辑但增加空指针判断：

import org.apache.poi.hssf.usermodel.HSSFChart;
import org.apache.poi.hssf.usermodel.HSSFDrawing;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.ss.usermodel.AnchorType;

// 假设dbSheet是你的HSSFSheet实例
HSSFDrawing drawing = (HSSFDrawing) dbSheet.getDrawingPatriarch();
if (drawing != null) {
    for (HSSFChart chart : drawing.getCharts()) {
        if (chart.getGraphicFrame() != null) {
            chart.getGraphicFrame().getAnchor().setAnchorType(AnchorType.DONT_MOVE_AND_RESIZE);
        }
    }
}

注意事项 #

• 确保使用的Apache POI版本为4.1.2及以上，旧版本的XDDF API可能存在功能缺失。
• 如果图表使用的是单单元格锚点（CTOneCellAnchor），需替换代码中的类型判断逻辑。

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