Apache POI：合并单元格区域内原比例居中适配图片问题

咱们一步步来搞定这个问题——你的代码里有几个关键细节没处理好，才导致了图片变形、高度不匹配和无法居中的情况。先拆解下原代码的问题：

1. 过早调用pict.resize()：这个方法会自动让图片适配锚点的单元格区域，覆盖你后续手动计算的缩放比例，导致变形。
2. 居中偏移计算错误：你计算Dx1时用了图片的原始宽度，没考虑缩放后的实际宽度，所以偏移量完全不对。
3. 行高计算未处理空行：如果合并区域里有未创建的行（sheet.getRow(i)为null），会漏掉默认行高，导致行高计算偏小。
4. 锚点的右下角偏移未设置：只指定了单元格区域，但没明确图片的实际大小，POI可能还是用原始图片尺寸渲染。

修正后的完整代码 #

// 1. 先读取图片获取原始尺寸（比用pict.getImageDimension()更可靠）
BufferedImage img = ImageIO.read(new ByteArrayInputStream(bytes));
int imgWidth = img.getWidth();
int imgHeight = img.getHeight();

int pictureIdx = wb.addPicture(bytes, pictype);
CreationHelper helper = wb.getCreationHelper();
Drawing drawing = sheet.createDrawingPatriarch();

// 2. 计算合并区域的总高度（处理空行的情况）
int totalRowHeightTwips = 0;
for (int i = row; i < row + rowspan; i++) {
    Row currentRow = sheet.getRow(i);
    if (currentRow == null) {
        // 空行使用工作表默认行高
        totalRowHeightTwips += sheet.getDefaultRowHeight();
    } else {
        totalRowHeightTwips += currentRow.getHeight();
    }
}

// 转换行高为像素：1 twip = 1/20点，1点 = 96/72像素 → 1 twip = 96/(72*20) = 1/15像素
int totalRowHeightPx = totalRowHeightTwips / 15;
int columnWidthPx = sheet.getColumnWidthInPixels(column);

// 3. 计算正确的缩放比例（保持原比例，取宽高限制的最小值）
float scale = 1.0f;
// 先按高度限制缩放
if (imgHeight > totalRowHeightPx) {
    scale = (float) totalRowHeightPx / imgHeight;
}
// 再按宽度限制调整，确保不超过列宽
float widthScale = (float) columnWidthPx / imgWidth;
if (widthScale < scale) {
    scale = widthScale;
}

int scaledImgWidth = (int) (imgWidth * scale);
int scaledImgHeight = (int) (imgHeight * scale);

// 4. 设置锚点：使用EMU单位（1像素=9525 EMU）
final int EMU_PER_PIXEL = 9525;
ClientAnchor anchor = helper.createClientAnchor();
// 锚点类型设为DONT_MOVE_AND_RESIZE，避免POI自动调整
anchor.setAnchorType(ClientAnchor.AnchorType.DONT_MOVE_AND_RESIZE);

// 绑定到目标单元格区域：单列，多行
anchor.setCol1(column);
anchor.setRow1(row);
anchor.setCol2(column + 1);
anchor.setRow2(row + rowspan);

// 计算居中偏移量（转成EMU）
int horizontalOffset = (columnWidthPx - scaledImgWidth) / 2 * EMU_PER_PIXEL;
int verticalOffset = (totalRowHeightPx - scaledImgHeight) / 2 * EMU_PER_PIXEL;

// 设置图片左上角的偏移（相对于单元格左上角）
anchor.setDx1(horizontalOffset);
anchor.setDy1(verticalOffset);

// 设置图片右下角的偏移（相对于单元格左上角，即图片的实际大小）
anchor.setDx2(scaledImgWidth * EMU_PER_PIXEL);
anchor.setDy2(scaledImgHeight * EMU_PER_PIXEL);

// 5. 创建图片，不要调用默认的resize()
Picture pict = drawing.createPicture(anchor, pictureIdx);

关键细节说明 #

• 图片尺寸获取：用ImageIO直接读取字节流获取尺寸，比pict.getImageDimension()更稳定，避免POI内部的尺寸转换误差。
• 行高计算：处理空行的默认行高，确保合并区域的总高度计算准确。
• 缩放逻辑：先以高度为限制计算缩放比例，再用宽度限制校验，保证图片在不超出单元格区域的前提下，保持原比例。
• 锚点单位：POI的锚点偏移用EMU（English Metric Unit），必须把像素转换为EMU才能准确定位，这是很多人容易忽略的点。
• 取消默认resize：不再调用pict.resize()，完全通过锚点的偏移量控制图片的大小和位置，避免自动调整带来的变形。

这样处理后，你的256x256正方形图片就能按原比例缩放，完美居中适配到单列多行的合并单元格区域里了。

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