Apache POI生成带批注Excel：编辑后批注形状由矩形变箭头的解决办法

我之前在处理Apache POI生成带批注的受保护Excel时，也碰到过一模一样的问题——首次打开批注是正常矩形，编辑保存后再打开就变成箭头形状了。折腾了好一阵才找到根源，下面是亲测有效的解决方案：

核心修复思路 #

问题出在Apache POI创建批注时的默认形状配置，以及Excel工作表保护后的渲染逻辑冲突。我们需要显式强制批注形状为矩形，同时合理设置工作表保护权限，避免编辑时触发Excel的自动形状调整。

完整Java代码示例 #

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.*;
import java.io.FileOutputStream;
import java.io.IOException;

public class ProtectedSheetCommentFix {
    public static void main(String[] args) throws IOException {
        try (XSSFWorkbook workbook = new XSSFWorkbook()) {
            XSSFSheet sheet = workbook.createSheet("Protected Sheet");
            
            // 创建目标单元格
            XSSFCell targetCell = sheet.createRow(1).createCell(1);
            targetCell.setCellValue("带固定形状的批注");
            
            // 创建批注并设置内容
            XSSFClientAnchor anchor = new XSSFClientAnchor(0, 0, 0, 0, (short)2, 1, (short)4, 4);
            XSSFComment comment = sheet.createDrawingPatriarch().createCellComment(anchor);
            comment.setString(workbook.getCreationHelper().createRichTextString("这是一个不会变形的矩形批注"));
            comment.setAuthor("POI Fix");
            
            // 关键步骤：强制设置批注形状为矩形
            if (comment.getShape() instanceof XSSFSimpleShape) {
                XSSFSimpleShape shape = (XSSFSimpleShape) comment.getShape();
                shape.setShapeType(ShapeTypes.RECTANGLE); // 指定矩形形状
            }
            
            // 设置工作表保护，同时允许批注相关操作（如果需要编辑批注）
            sheet.protectSheet("yourPassword",
                    SheetProtection.AllowInsertingComments |
                    SheetProtection.AllowEditingComments |
                    SheetProtection.AllowFormattingCells);
            
            // 写入文件
            try (FileOutputStream fos = new FileOutputStream("fixed_comment_protected.xlsx")) {
                workbook.write(fos);
            }
        }
    }
}

方案原理 #

1. 默认形状问题：Apache POI默认创建的批注使用ShapeTypes.COMMENT（箭头气泡形状），在工作表受保护且编辑后，Excel会自动调整这个默认形状的显示样式；
2. 强制矩形：显式设置ShapeTypes.RECTANGLE后，Excel会始终以矩形渲染批注，不受保护状态的影响；
3. 权限配置：保护工作表时添加批注相关的操作权限，避免Excel因权限限制强制修改批注形状。

示例效果 #

首次打开时的矩形批注

编辑保存后重新打开的矩形批注

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