Java POI合并单元格边框消失？3种解决方案实测对比（附完整代码）

Java POI合并单元格边框消失？3种解决方案实测对比（附完整代码）

如果你用过Apache POI处理过Excel报表，尤其是那些需要合并单元格的复杂表头，大概率会遇到一个让人头疼的问题：合并后的单元格边框神秘消失了。明明给每个单元格都设置了边框样式，合并之后却只剩下左上角那个单元格有边框，其他部分一片空白，导出的Excel文件看起来就像没完工的半成品。这个问题在生成财务报表、数据汇总表或者任何需要视觉分隔的文档时尤其突出，直接影响最终输出的专业度。

我最初遇到这个问题时，花了整整一个下午调试，试了各种方法都不奏效。后来才发现，这其实是POI处理合并单元格时的一个设计特性——合并区域只保留第一个单元格的样式。理解了这个机制，解决方案就清晰多了。今天我就把自己在实际项目中验证过的三种方案整理出来，从最基础的循环设置到最高效的工具类封装，每种方案都有完整的代码示例和适用场景分析，你可以根据自己的项目需求选择最合适的那一个。

1. 问题根源：为什么合并单元格后边框会消失？

要解决边框消失的问题，首先得明白POI内部是怎么处理单元格合并的。当你调用sheet.addMergedRegion()方法时，POI并不是真的把多个单元格“融合”成一个，而是在内部记录了一个合并区域的范围。这个区域内的所有单元格仍然独立存在，但只有左上角第一个单元格（我们称之为“锚点单元格”）的内容和样式会被显示。

// 创建一个合并区域：从第2行到第4行，第3列到第5列
CellRangeAddress mergedRegion = new CellRangeAddress(1, 3, 2, 4);
sheet.addMergedRegion(mergedRegion);

执行这段代码后，Excel会显示一个合并后的单元格，但实际上B2、B3、B4、C2、C3、C4、D2、D3、D4这9个单元格都还在。如果你只给B2设置了边框样式，那么其他8个单元格就没有样式，这就是边框“消失”的真正原因。

注意：这里有个容易混淆的点。在Excel界面中合并单元格时，合并后的区域会继承第一个单元格的样式。但POI的addMergedRegion()方法只负责合并，不负责样式传播。这是API设计上的一个“坑”，很多开发者第一次用都会踩到。

为了更直观地理解这个问题，我们来看一个对比表格：

这个问题的本质是样式作用域的错配。我们以为合并操作会创建一个新的“超级单元格”，但实际上它只是隐藏了其他单元格的显示。要解决这个问题，就需要手动把样式应用到合并区域内的每一个单元格。

2. 方案一：基础循环法——逐个单元格设置样式

这是最直观的解决方案，思路很简单：既然合并区域内的每个单元格都需要样式，那就遍历所有单元格，一个一个设置。这种方法虽然看起来有点“笨”，但胜在逻辑清晰，容易理解和调试。

2.1 实现代码与步骤分解

先来看完整的工具方法实现：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.ss.util.CellRangeAddress;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;

/**
 * 方案一：基础循环设置样式
 * 适用于简单的合并场景，代码直观易懂
 */
public class BorderSolution1 {
    
    /**
     * 为合并区域内的所有单元格设置边框样式
     * @param sheet 工作表对象
     * @param mergedRegion 合并区域
     * @param borderStyle 边框样式（如BorderStyle.THIN）
     */
    public static void setBorderForMergedRegion(Sheet sheet, 
                                                CellRangeAddress mergedRegion, 
                                                BorderStyle borderStyle) {
        // 1. 创建或获取单元格样式
        Workbook workbook = sheet.getWorkbook();
        CellStyle borderCellStyle = workbook.createCellStyle();
        
        // 设置四边边框
        borderCellStyle.setBorderBottom(borderStyle);
        borderCellStyle.setBorderLeft(borderStyle);
        borderCellStyle.setBorderRight(borderStyle);
        borderCellStyle.setBorderTop(borderStyle);
        
        // 2. 遍历合并区域内的每一行
        for (int rowNum = mergedRegion.getFirstRow(); 
             rowNum <= mergedRegion.getLastRow(); 
             rowNum++) {
            
            Row row = sheet.getRow(rowNum);
            if (row == null) {
                row = sheet.createRow(rowNum);
            }
            
            // 3. 遍历该行的每一列
            for (int colNum = mergedRegion.getFirstColumn();
                 colNum <= mergedRegion.getLastColumn();
                 colNum++) {
                
                Cell cell = row.getCell(colNum);
                if (cell == null) {
                    cell = row.createCell(colNum);
                }
                
                // 4. 应用边框样式
                cell.setCellStyle(borderCellStyle);
            }
        }
    }
    
    /**
     * 完整的示例：创建带合并单元格和边框的Excel
     */
    public static void createExcelWithBorders() {
        // 创建工作簿和工作表
        Workbook workbook = new XSSFWorkbook();  // 使用.xlsx格式
        Sheet sheet = workbook.createSheet("测试报表");
        
        // 创建表头行
        Row headerRow = sheet.createRow(0);
        String[] headers = {"序号", "产品名称", "第一季度", "第二季度", "第三季度", "第四季度", "年度总计"};
        
        for (int i = 0; i < headers.length; i++) {
            Cell cell = headerRow.createCell(i);
            cell.setCellValue(headers[i]);
            
            // 为表头设置基础样式
            CellStyle headerStyle = workbook.createCellStyle();
            headerStyle.setBorderBottom(BorderStyle.THIN);
            headerStyle.setBorderLeft(BorderStyle.THIN);
            headerStyle.setBorderRight(BorderStyle.THIN);
            headerStyle.setBorderTop(BorderStyle.THIN);
            headerStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
            headerStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
            cell.setCellStyle(headerStyle);
        }
        
        // 合并"年度总计"上方的季度单元格
        CellRangeAddress quarterMerge = new CellRangeAddress(0, 0, 2, 5);
        sheet.addMergedRegion(quarterMerge);
        
        // 关键步骤：为合并区域设置边框
        setBorderForMergedRegion(sheet, quarterMerge, BorderStyle.THIN);
        
        // 设置合并单元格的内容
        Cell mergedCell = headerRow.getCell(2);
        mergedCell.setCellValue("季度销售额（万元）");
        
        // 保存文件
        try (FileOutputStream fos = new FileOutputStream("sales_report.xlsx")) {
            workbook.write(fos);
            System.out.println("Excel文件生成成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

2.2 方案优缺点分析

优点：

• 逻辑清晰：代码直白，一看就懂，特别适合POI初学者
• 可控性强：可以精确控制每个单元格的样式，不仅仅是边框
• 兼容性好：适用于所有POI版本，从老旧的3.x到最新的5.x都能用
• 调试方便：如果出现问题，可以很容易地定位到具体是哪个单元格设置有问题

缺点：

• 性能问题：如果合并区域很大（比如合并了1000个单元格），循环遍历会消耗较多时间
• 内存占用：每个单元格都创建独立的CellStyle对象，当样式复杂时可能占用较多内存
• 代码冗余：每次设置合并单元格边框都要写一遍循环逻辑

适用场景：

• 小型Excel文件，合并单元格数量不多
• 需要快速验证解决方案的原型阶段
• 对性能要求不高的内部工具
• 教育或演示目的，需要代码易于理解

我在实际项目中发现，当合并单元格数量在100个以内时，这种方法的性能差异几乎可以忽略不计。但对于需要生成大型报表的系统，就需要考虑更高效的方案了。

3. 方案二：RegionUtil工具类——POI官方推荐方案

Apache POI从3.14版本开始，在org.apache.poi.ss.util包中提供了RegionUtil工具类，专门用于处理合并区域的边框设置。这是POI官方推荐的解决方案，代码更简洁，执行效率也更高。

3.1 RegionUtil的核心用法

RegionUtil提供了静态方法来直接为合并区域设置边框，不需要遍历每个单元格。它的工作原理是直接操作底层的Excel文件结构，效率比循环设置要高得多。

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.ss.util.CellRangeAddress;
import org.apache.poi.ss.util.RegionUtil;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

/**
 * 方案二：使用RegionUtil工具类
 * POI官方推荐，代码简洁高效
 */
public class BorderSolution2 {
    
    /**
     * 使用RegionUtil为合并区域设置统一边框
     * @param sheet 工作表
     * @param mergedRegion 合并区域
     * @param borderStyle 边框样式
     */
    public static void setBorderWithRegionUtil(Sheet sheet,
                                               CellRangeAddress mergedRegion,
                                               BorderStyle borderStyle) {
        // 设置四边边框 - 这是最核心的代码
        RegionUtil.setBorderBottom(borderStyle, mergedRegion, sheet);
        RegionUtil.setBorderLeft(borderStyle, mergedRegion, sheet);
        RegionUtil.setBorderRight(borderStyle, mergedRegion, sheet);
        RegionUtil.setBorderTop(borderStyle, mergedRegion, sheet);
        
        // 如果需要设置边框颜色，可以这样写
        // RegionUtil.setBorderBottom(borderStyle, mergedRegion, sheet, workbook);
        // RegionUtil.setBottomBorderColor(IndexedColors.BLACK.getIndex(), mergedRegion, sheet, workbook);
    }
    
    /**
     * 复杂表头示例：多级合并单元格的边框处理
     */
    public static void createComplexHeader() {
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("复杂表头示例");
        
        // 第一行：主标题
        Row row1 = sheet.createRow(0);
        Cell mainTitle = row1.createCell(0);
        mainTitle.setCellValue("2024年度销售数据分析报表");
        
        // 合并A1到G1
        CellRangeAddress titleMerge = new CellRangeAddress(0, 0, 0, 6);
        sheet.addMergedRegion(titleMerge);
        
        // 为标题设置边框和样式
        CellStyle titleStyle = workbook.createCellStyle();
        titleStyle.setAlignment(HorizontalAlignment.CENTER);
        titleStyle.setVerticalAlignment(VerticalAlignment.CENTER);
        Font titleFont = workbook.createFont();
        titleFont.setBold(true);
        titleFont.setFontHeightInPoints((short) 16);
        titleStyle.setFont(titleFont);
        mainTitle.setCellStyle(titleStyle);
        
        // 使用RegionUtil设置边框
        setBorderWithRegionUtil(sheet, titleMerge, BorderStyle.MEDIUM);
        
        // 第二行：二级表头
        Row row2 = sheet.createRow(1);
        String[] secondHeaders = {"基本信息", "", "", "销售数据", "", "", "财务指标"};
        for (int i = 0; i < secondHeaders.length; i++) {
            row2.createCell(i).setCellValue(secondHeaders[i]);
        }
        
        // 合并第二行的部分单元格
        CellRangeAddress basicInfoMerge = new CellRangeAddress(1, 1, 0, 2);  // 基本信息
        CellRangeAddress salesDataMerge = new CellRangeAddress(1, 1, 3, 5);  // 销售数据
        CellRangeAddress financeMerge =