Java实现Word文档加密：保护敏感信息的最佳实践

1. 引言

在办公自动化领域，Word文档的加密是保护机密信息的重要手段。Java作为企业级开发的主流语言，提供了多种库来实现Word文档的密码保护。本文将对比两种常用方案：Apache POI和Spire.Doc，并给出详细的代码实现与注意事项。

2. 使用Apache POI加密Word文档

Apache POI是处理Microsoft Office文档的开源Java库。从4.1.0版本开始，POI支持对Word文档（.docx）进行加密。核心思路是使用CTOoxmlEncryption类。

2.1 添加依赖

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>

2.2 加密示例

import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
import org.apache.poi.openxml4j.opc.OPCPackage;
import org.apache.poi.poifs.crypt.EncryptionInfo;
import org.apache.poi.poifs.crypt.EncryptionMode;
import org.apache.poi.poifs.crypt.Encryptor;
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import java.io.*;

public class WordEncryptor {
    public static void encrypt(String inputPath, String outputPath, String password) throws IOException, InvalidFormatException {
        try (POIFSFileSystem fs = new POIFSFileSystem();
             InputStream is = new FileInputStream(inputPath)) {
            EncryptionInfo info = new EncryptionInfo(EncryptionMode.agile);
            Encryptor enc = info.getEncryptor();
            enc.confirmPassword(password);
            try (OPCPackage opc = OPCPackage.open(is);
                 OutputStream os = new FileOutputStream(outputPath)) {
                os.write(enc.getEncryptedData(opc));
            }
        }
    }
    public static void main(String[] args) throws Exception {
        encrypt("input.docx", "encrypted.docx", "secret123");
    }
}

注意：此方法仅支持.docx格式，且加密后需使用密码才能打开。

3. 使用Spire.Doc加密Word文档

Spire.Doc是商业库，提供更简单的API，支持.doc和.docx。首先获取免费试用版或购买授权。

3.1 添加依赖（Maven）

<dependency>
    <groupId>e-iceblue</groupId>
    <artifactId>spire.doc</artifactId>
    <version>11.8.8</version>
</dependency>

3.2 加密示例

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class SpireWordEncrypt {
    public static void main(String[] args) {
        Document doc = new Document();
        doc.loadFromFile("input.docx");
        doc.encrypt("mypassword");
        doc.saveToFile("encrypted_spire.docx", FileFormat.Docx);
    }
}

Spire.Doc一行代码即可完成加密，但商业使用需付费。

4. 加密原理与安全性

Word文档加密采用AES加密算法（如Agile模式），密钥由用户密码派生。需要注意：

• 密码强度：使用长密码并包含特殊字符，避免字典攻击。
• 加密模式：POI选择Agile模式（ECMA-376标准），推荐优先使用。
• 性能：加密大文件时内存开销较大，建议分块处理或使用流式API。

5. 最佳实践

1. 备份原始文件：加密前保留未加密副本，防止密码丢失导致数据不可用。
2. 密码管理：不硬编码密码，使用环境变量或密钥管理服务。
3. 兼容性：测试不同Office版本（2010/2013/2016/365）对加密的支持。
4. 错误处理：捕获异常如InvalidFormatException，给出用户友好提示。

6. 总结

本文介绍了Java中两种主流的Word文档加密方法。Apache POI开源免费但API较复杂，适合对性能有要求的场景；Spire.Doc简单易用但需商业授权。选择时需权衡成本与开发效率。无论哪种方案，都应遵循安全编码规范，确保数据机密性。