使用Apache POI写入受保护.xls文件后损坏的解决办法问询

问题背景 #

使用Apache POI的HSSFWorkbook读取受保护的.xls工作簿并写入数据后，文件出现损坏提示：“We found a problem with some content in...”，修复后丢失部分公式和单元格样式。工作簿包含两个带数据验证列表的单元格（54项、229项，后者为自定义日期格式），且对应工作表受保护。

核心原因 #

1. HSSFWorkbook直接读取并重写时，对旧版BIFF格式的复杂元素（如工作表保护、大量数据验证、自定义格式）解析和重构支持不完善，易破坏原有文件结构。
2. 直接写入字符串格式的数值（如"10.00"）会覆盖单元格原有数据类型和样式。
3. 超过50项的数据验证列表，HSSF解析时可能出现异常，导致验证规则丢失。

可行解决方案 #

• 改用POIFSFileSystem读取：通过POIFSFileSystem读取原始文件流，保留更多底层文件结构，减少格式丢失。
• 临时解除工作表保护：写入前临时关闭工作表保护，完成后重新应用（需使用原保护密码）。
• 匹配单元格数据类型：根据目标单元格原有类型设置值，避免破坏格式。
• 手动修复数据验证规则：若数据验证丢失，通过POI重新构建验证列表。

修正后的代码示例 #

import org.apache.poi.hssf.usermodel.*;
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import java.io.*;

public class ProtectedXlsWriter {
    public static void main(String[] args) throws IOException {
        String sourcePath = "D:/Test/Test.xls";
        String outputPath = "D:/Out/Test_Updated.xls";
        String sheetProtectionPassword = "yourActualPassword"; // 替换为工作表保护密码

        // 用POIFSFileSystem读取原始文件，保留结构完整性
        POIFSFileSystem poifs = new POIFSFileSystem(new FileInputStream(sourcePath));
        HSSFWorkbook workbook = new HSSFWorkbook(poifs);
        poifs.close();

        HSSFSheet targetSheet = workbook.getSheetAt(1);

        // 临时解除工作表保护（如果已保护）
        if (targetSheet.getProtect()) {
            targetSheet.setProtect(false, sheetProtectionPassword);
        }

        // 获取目标单元格，确保单元格存在
        HSSFRow row = targetSheet.getRow(10);
        if (row == null) {
            row = targetSheet.createRow(10);
        }
        HSSFCell cell = row.getCell(2);
        if (cell == null) {
            cell = row.createCell(2);
        }

        // 按数值类型设置值，保留原有单元格样式
        cell.setCellValue(10.00);
        // 若需强制保留两位小数，可复用原有样式
        // HSSFCellStyle originalStyle = cell.getCellStyle();
        // cell.setCellStyle(originalStyle);

        // 重新启用工作表保护
        targetSheet.setProtect(true, sheetProtectionPassword);

        // 写入并关闭资源
        FileOutputStream outputStream = new FileOutputStream(outputPath);
        workbook.write(outputStream);
        outputStream.flush();
        outputStream.close();
        workbook.close();
    }
}

额外处理：数据验证规则修复 #

如果数据验证列表丢失，可通过以下代码重新构建：

// 示例：为单元格(10,2)添加数据验证列表
HSSFDataValidationHelper dvHelper = new HSSFDataValidationHelper(targetSheet);
// 替换为实际的选项数组
String[] validationOptions = {"选项1", "选项2", "选项3", "..."};
HSSFDataValidationConstraint dvConstraint = dvHelper.createExplicitListConstraint(validationOptions);
// 指定应用验证的单元格范围：行10到10，列2到2
CellRangeAddressList addressList = new CellRangeAddressList(10, 10, 2, 2);
HSSFDataValidation validation = dvHelper.createValidation(dvConstraint, addressList);
targetSheet.addValidationData(validation);

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