XSSFWorkbook.lockStructure()在LibreOffice中无效，如何兼容保护XLSX结构？

问题原因 #

这不是LibreOffice的bug，而是Apache POI的当前实现与LibreOffice对OOXML工作簿保护的解析逻辑存在差异。你的代码调用lockStructure()和setWorkbookPassword后，生成的文件仅满足了Microsoft Excel的保护校验逻辑，但缺少LibreOffice识别结构保护所需的完整配置项，且默认的密码哈希算法兼容性不足。

解决方案 #

修改代码，手动补充LibreOffice需要的工作簿保护属性，并指定兼容的哈希算法：

import org.apache.poi.poifs.crypt.HashAlgorithm;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTWorkbook;
import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTWorkbookProtection;
import java.io.FileOutputStream;

public class ProtectedXlsxCreator {
    private static final String PASSWORD = "your-protection-password";

    public static void main(String[] args) throws Exception {
        XSSFWorkbook wb = new XSSFWorkbook();
        
        // 启用结构锁定
        wb.lockStructure();
        // 使用SHA-512哈希算法设置密码，提升与LibreOffice的兼容性
        wb.setWorkbookPassword(PASSWORD, HashAlgorithm.sha512);
        
        // 手动确保OOXML中存在明确的结构锁定配置
        CTWorkbook ctWorkbook = wb.getCTWorkbook();
        CTWorkbookProtection protection = ctWorkbook.getWorkbookProtection();
        if (protection == null) {
            protection = ctWorkbook.addNewWorkbookProtection();
        }
        // 显式标记结构锁定
        protection.setLockStructure(true);

        // 写入并关闭文件
        try (FileOutputStream fos = new FileOutputStream("protected.xlsx")) {
            wb.write(fos);
        }
        wb.close();
    }
}

关键说明 #

• 选择HashAlgorithm.sha512是因为LibreOffice对SHA-512的密码哈希支持更稳定，POI默认使用的SHA-1在部分LibreOffice版本中识别性不足。
• 手动设置CTWorkbookProtection的lockStructure属性，避免POI的封装方法遗漏该核心配置，确保生成的OOXML文件能被LibreOffice正确解析为结构保护状态。

内容的提问来源于stack exchange，提问作者marciel.deg