Apache POI 5.4.1自动调整列宽后模板图片比例失调问题咨询

问题定性 #

这是Apache POI处理自动列宽时的兼容性Bug，既不是你操作有误，也不是设计特性。

触发逻辑 #

调用sheet.autoSizeColumn(columnIndex)时，POI会重新计算列宽的像素值，但它的处理逻辑未兼顾页眉/页脚中嵌入图片的关联布局——即便你设置了图片的移动/缩放属性，POI在自动调整列宽过程中仍可能错误修改页眉图片的容器尺寸或缩放比例，导致图片拉伸畸形。

解决方案 #

• 调整操作顺序：先完成所有autoSizeColumn调用，再处理页眉图片（模板原有图片可先移除，调整列宽后重新插入）。示例代码：

  // 先执行自动列宽调整
  sheet.autoSizeColumn(0);
  sheet.autoSizeColumn(1);
  // 再重新插入页眉Logo
  Header header = sheet.getHeader();
  // 移除原有图片（若模板已有）
  header.setLeft("");
  // 插入新图片
  header.setLeftPicture(new FileInputStream("logo.png"), PictureType.PNG);
  header.setLeft("&G");
  

• 手动设置列宽：预先估算文本所需列宽，用sheet.setColumnWidth(columnIndex, width)替代自动调整，规避POI的布局干扰。列宽单位为1/256字符宽度，示例：

  // 设置第0列宽度为22个字符宽度
  sheet.setColumnWidth(0, 22 * 256);
  

• 升级POI版本：该问题在POI 5.2.0之后的部分版本中有修复尝试，可升级至最新稳定版（如5.2.5及以上）验证是否解决。

验证建议 #

优先测试调整操作顺序的方案，若模板原有图片无法直接移除，可尝试先清空页眉内容再重新插入。若仍无效，手动设置列宽是最稳妥的规避方式。

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