使用Apache POI加密的复杂.doc文件无法在Microsoft Word中打开求助

问题场景 #

• 加密结构简单的.doc文件时，加密后的文件可正常用Microsoft Word打开
• 加密包含复杂元素（如图片、多层样式、表格、嵌入式资源等）的.doc文件时，Word无法打开加密后的文件
• 使用的加密代码如下：

public static boolean encrypDOC(String sourceFilePath, OutputStream out, String password) throws IOException {
        POIFSFileSystem fs = null;
        HWPFDocument doc = null;
        try {
            fs = new POIFSFileSystem(new FileInputStream(sourceFilePath));
            doc = new HWPFDocument(fs);
            Biff8EncryptionKey.setCurrentUserPassword(password);
            doc.write(out);
            return true;
        } catch (Exception e) {
            return false;
        } finally {
            doc.close();
            fs.close();
            out.close();
        }
}

问题原因 #

1. 加密方式局限性：Biff8EncryptionKey.setCurrentUserPassword仅针对BIFF8格式的基础加密逻辑，无法处理复杂DOC文件中的特殊结构（如OLE对象、样式流、嵌入式资源等），导致加密后文件结构损坏，Word无法解析。
2. 资源关闭风险：finally块中直接调用doc.close()，若复杂文件读取失败导致doc为null，会触发空指针异常，后续资源无法正常关闭，进一步破坏文件完整性。

解决方法 #

1. 修复资源关闭逻辑 #

在finally块中先判断对象是否为null，再执行关闭操作，避免空指针异常。

2. 使用完整POIFS加密流程 #

针对复杂DOC文件，需要将整个POIFS文件系统进行加密，而非仅设置文档密码属性。修改后的代码如下：

public static boolean encryptDOC(String sourceFilePath, OutputStream out, String password) throws IOException {
    POIFSFileSystem fs = null;
    HWPFDocument doc = null;
    POIFSFileSystem encryptedFs = null;
    try {
        fs = new POIFSFileSystem(new FileInputStream(sourceFilePath));
        doc = new HWPFDocument(fs);
        
        // 创建加密的POIFS文件系统容器
        encryptedFs = new POIFSFileSystem();
        // 设置全局加密密码
        Biff8EncryptionKey.setCurrentUserPassword(password);
        // 将文档写入加密容器
        doc.write(encryptedFs);
        // 输出加密后的完整文件系统
        encryptedFs.writeFilesystem(out);
        
        return true;
    } catch (Exception e) {
        e.printStackTrace(); // 保留异常日志便于排查复杂文件的特殊问题
        return false;
    } finally {
        // 安全关闭所有资源，逐个判断非空
        if (doc != null) {
            try { doc.close(); } catch (IOException e) { e.printStackTrace(); }
        }
        if (fs != null) {
            try { fs.close(); } catch (IOException e) { e.printStackTrace(); }
        }
        if (encryptedFs != null) {
            try { encryptedFs.close(); } catch (IOException e) { e.printStackTrace(); }
        }
        if (out != null) {
            try { out.close(); } catch (IOException e) { e.printStackTrace(); }
        }
    }
}

额外说明 #

• 若修改后仍无法打开，需检查复杂DOC文件是否包含HWPF不支持的特殊元素（如新版Word专属格式、罕见OLE对象），可尝试将文件转换为.docx格式后用XWPF处理，或借助第三方加密工具辅助。

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