Apache POI 3.17合并单元格setWrapText(true)无法触发行高调整求助

我之前在使用Apache POI 3.17生成xlsx时，也踩过合并单元格+自动换行不自动调整行高的坑，给你几个经过验证的解决思路：

核心原因 #

POI在处理合并单元格时，不会自动计算并调整行高——即使你设置了setWrapText(true)，因为合并区域的行高计算逻辑和普通单元格不同，它无法自动识别合并单元格内的换行内容对应的高度需求。

可行解决方案 #

1. 手动计算并设置行高 #

这是最直接有效的方法，需要你根据单元格内容、字体大小和列宽，计算出需要的行高后手动设置。下面是一个简化的实现示例：

// 假设你已经创建了合并区域CellRangeAddress
CellRangeAddress mergedArea = new CellRangeAddress(0, 0, 0, 2); // 示例合并区域：第1行，第1-3列
Sheet sheet = workbook.createSheet("测试页");
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);

// 设置单元格内容（包含换行符\n）
cell.setCellValue("这是一段需要换行的长文本\n第二行内容\n第三行内容");

// 设置自动换行样式
CellStyle cellStyle = workbook.createCellStyle();
Font font = workbook.createFont();
font.setFontHeightInPoints((short)12); // 设置字体大小
cellStyle.setFont(font);
cellStyle.setWrapText(true);
cell.setCellStyle(cellStyle);

// 合并单元格
sheet.addMergedRegion(mergedArea);

// 计算需要的行高
String content = cell.getStringCellValue();
int fontSize = font.getFontHeightInPoints();
// 获取列宽（POI的列宽单位是1/256个字符宽度）
int columnWidth = sheet.getColumnWidth(mergedArea.getFirstColumn()) / 256;
// 简单计算行数（如果是中文等双字节字符，需要调整字符长度计算）
int lineCount = content.split("\n").length;
// 每行的高度大概是字体大小的1.2倍（可根据需求调整）
float requiredHeight = fontSize * lineCount * 1.2f;
// 设置行高
row.setHeightInPoints(requiredHeight);

2. 确保换行符正确 #

POI只识别\n作为自动换行的触发符，如果你用了\r\n或者其他换行符，自动换行可能不会生效，导致行高不调整。所以要确保单元格内容里的换行是单个\n。

3. 避免依赖自动行高设置 #

不要尝试用row.setHeightInPoints((short)-1)来让POI自动调整行高——在合并单元格场景下，这个设置完全无效，必须手动计算后设置具体的行高值。

进阶优化 #

如果需要更精确的行高计算（比如处理不同字符宽度、复杂排版），可以使用Java的FontMetrics类来计算文本的实际高度，或者借助POI的org.apache.poi.ss.usermodel.Font相关方法来获取更准确的字体度量信息。

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