使用 GroupDocs.Merger for Java 移除 Word 文档密码

管理文档安全至关重要，remove password from Word（移除 Word 文档密码）是自动化文档工作流的开发者经常需要的功能。在本指南中，我们将演示如何使用 GroupDocs.Merger for Java 移除 Word（以及其他）文档的密码保护。完成后，您将了解如何设置库、加载受密码保护的文件、解锁加密内容并保存未受保护的版本——所有代码均为清晰、可用于生产的示例。

快速答案

主要方法是什么？ Merger.removePassword() 用于移除已加载文档的密码。
哪个类用于加载受保护的文件？ LoadOptions 允许您指定已有的密码。
我也可以解锁 PDF 文件吗？ 可以——相同的方法适用于 PDF（remove pdf password java）。
是否需要许可证？ 试用版可用于测试；生产环境需要正式许可证。
需要哪个 Java 版本？ Java 8 及以上，配合 Maven 或 Gradle 使用。

什么是 “remove password from Word”？

从 Word 文档中移除密码指的是使用正确的密码打开加密文件，去除加密层并保存为未加密的副本。这使得后续流程——如合并、转换或索引——能够在无需人工干预的情况下运行。

为什么使用 GroupDocs.Merger for Java？

GroupDocs.Merger 提供了一个统一且高性能的 API，支持多种格式（DOCX、PDF、PPTX 等）。它将底层加密细节抽象化，使您能够专注于业务逻辑，而无需处理文件格式的特殊之处。

前置条件

Java Development Kit (JDK) 8 或更高版本 已安装。
Maven 或 Gradle 作为构建系统。
具备 Java I/O 与异常处理的基础知识。

必需的库、版本及依赖

在项目中引入 GroupDocs.Merger for Java：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

implementation 'com.groupdocs:groupdocs-merger:latest-version'

您也可以直接从 GroupDocs.Merger for Java releases 下载该库。

环境搭建要求

已安装 Java Development Kit (JDK)。
如 IntelliJ IDEA 或 Eclipse 等 IDE（可选，但推荐）。

知识前提

假设您已熟悉基本的 Java 编程以及文件 I/O 操作。了解 Maven 或 Gradle 构建系统将更有帮助。

设置 GroupDocs.Merger for Java

安装信息

Maven 与 Gradle：使用上面的代码片段添加依赖。
直接下载：访问 GroupDocs.Merger for Java releases 下载最新的 JAR 包。

许可证获取步骤

通过从官网下载安装，开始使用 免费试用。
如需更长时间，可申请 临时许可证。
在 GroupDocs.Merger purchase page 购买正式许可证用于生产环境。

安装完成后，按如下方式初始化库：

import com.groupdocs.merger.Merger;
// Other necessary imports...
public class DocumentUnlocker {
    public static void main(String[] args) {
        // Initialize and setup code here
    }
}

实现指南

本节将指导您使用 GroupDocs.Merger for Java 移除文档密码 的完整步骤。

功能概述：移除密码保护

GroupDocs.Merger 支持文档操作，包括移除密码。此功能在不破坏安全协议的前提下，简化了对受保护文件的访问。

步骤 1：定义文件路径和加载选项

First, specify where your protected document is stored and set up load options with the existing password:

import com.groupdocs.merger.domain.options.LoadOptions;

String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX_PROTECTED";
LoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");

为什么：LoadOptions 类可安全地 加载受密码保护的文档。

步骤 2：初始化 Merger 对象

Next, create a Merger object using the file path and load options:

import com.groupdocs.merger.Merger;

Merger merger = new Merger(filePath, loadOptions);

为什么：Merger 类是处理文档的核心，封装了所有功能，包括解锁特性。

步骤 3：移除密码保护

Use the removePassword() method to strip the document’s password:

merger.removePassword();

为什么：此方法会修改文档结构以 移除密码（或解锁加密文件），从而可以在无需密码的情况下打开。

步骤 4：保存未受保护的文档

Finally, save the unprotected document to your desired location:

String filePathOut = "YOUR_OUTPUT_DIRECTORY/RemoveDocumentPassword-" + Paths.get(filePath).getFileName().toString();
merger.save(filePathOut);

为什么：保存可确保更改被提交，并将文档存放在新目录或已有目录中。

故障排除技巧

确保在 LoadOptions 中提供了正确的密码。
检查文件路径，避免出现 FileNotFoundException。
捕获并记录 Merger 方法抛出的任何异常，以便及时诊断问题。

实际应用

GroupDocs.Merger 功能多样，适用于以下场景：

自动化文档处理 – 在后续处理前批量解锁多个文件。
数据迁移项目 – 临时移除密码以安全迁移内容。
与内容管理系统 (CMS) 集成 – 提升 CMS 管理受保护文档的能力。

性能考虑

为了保持解决方案的高速和内存高效，请注意：

尽可能使用流式 I/O。
保存后及时释放 Merger 实例。
在批处理场景下，处理同一格式的多个文件时复用同一个 Merger 实例。

常见问题与解决方案

问题	解决方案
`Incorrect password` 错误	再次检查传递给 `LoadOptions` 的密码字符串。
`OutOfMemoryError`（大文件）	将文件分块处理或增大 JVM 堆大小（`-Xmx`）。
`Unsupported file format`（不支持的文件格式）	确认该文件类型已列在 GroupDocs.Merger 支持的格式中。

常见问答

GroupDocs.Merger for Java 的主要用途是什么？
- 用于便捷地进行文档操作，包括合并、拆分以及 remove password（移除密码）等功能。
我可以在其他编程语言中使用该库吗？
- 可以，GroupDocs 为 .NET、C++ 等语言提供了类似的 API。
在生产环境中使用 GroupDocs.Merger 是否需要许可证？
- 商业部署必须购买正式许可证。
在移除密码过程中如何处理错误？
- 捕获异常，记录堆栈信息，并在必要时使用正确的凭据重试。
哪些文档类型可以被解锁？
- Word、Excel、PowerPoint、PDF 以及 GroupDocs.Merger 支持的其他多种格式。

资源

最后更新： 2026-01-29
测试版本： GroupDocs.Merger 23.12（最新）
作者： GroupDocs