C# 快速检测 PDF 是否加密，并验证正确密码

引言：为什么需要检测PDF加密状态？

在批量文档处理系统（如 OCR 文字识别、内容提取、格式转换）中，加密 PDF 无法直接操作。检测加密状态可提前筛选文件，避免流程因密码验证失败而中断。
本文使用 Free Spire.PDF for .NET（一个免费的.NET PDF处理库），演示如何通过C# 检测PDF是否加密，并验证密码的正确性。

目录

引言：为什么需要检测PDF加密状态？

Free Spire.PDF for .NET简介

C# 检测PDF文档是否加密

C# 测试PDF正确密码

批量检测+密码测试 （完整企业级解决方案）

总结

---

Free Spire.PDF for .NET简介

核心功能：

• 免费提供基础的PDF创建、编辑和加密检测功能
• 支持.NET Framework 和 .NET Core
• 无需Adobe依赖

安装方式：
可以通过 NuGet 包管理器来完成安装。打开 Visual Studio，在项目中右键点击 "管理 NuGet 程序包"，搜索 "Free Spire.PDF"，然后选择合适的版本进行安装。

⚠️ 关键提示： 加密检测 ≠ 破解工具。Spire.PDF仅对合法持有的文件进行操作。

C# 检测PDF文档是否加密

要检测一个PDF文件的加密状态，可以直接使用 PdfDocument 类的 IsPasswordProtected(string fileName) 方法。该属性返回一个布尔值，如果为true，表示 PDF 已加密；如果为false，表示 PDF 未加密。示例C#代码如下：

using Spire.Pdf;namespace CheckIfPdfIsProtected
{class Program{static void Main(string[] args){// 指定PDF文档路径string pdfPath = "E:\\PythonPDF\\加密PDF.pdf";// 检测PDF文档是否加密bool isProtected = PdfDocument.IsPasswordProtected(pdfPath);// 输出结果if (isProtected){Console.WriteLine("该PDF已加密。");}else{Console.WriteLine("该PDF未加密。");}}}
}

输出结果：

C# 测试PDF正确密码

如果检测到 PDF 已加密，接下来需要测试正确的密码。Free Spire.PDF for .NET没有直接的验证密码的接口，但是可以通过尝试用密码打开PDF文件并捕获异常来验证。

示例C#代码如下：

using Spire.Pdf;namespace DetermineTheCorrectPasswordOfPdf
{class Program{static void Main(string[] args){// 指定PDF文件和测试密码string pdfPath = "加密PDF.pdf";string[] testPasswords = { "admin@2023", "abc", "12345" };// 遍历测试密码foreach (var pwd in testPasswords){if (ValidatePdfPassword(pdfPath, pwd)){Console.WriteLine($"成功！正确密码为：{pwd}");break;}}// 验证PDF密码的方法static bool ValidatePdfPassword(string filePath, string password){// 用测试密码逐一打开PDF进行验证PdfDocument pdf = new PdfDocument();try{pdf.LoadFromFile(filePath, password);// 无异常 = 密码正确  return true;}catch (Exception){return false; // 密码错误  }finally{pdf.Close();}}}}
}

输出结果：

批量检测+密码测试 （完整企业级解决方案）：

对于需要批量处理文档应用场景，如：

1. 企业文档管理：批量检测加密 PDF 并尝试常用密码（如部门默认密码），解决密码遗忘导致的文档访问问题。
2. 数据恢复：针对恢复出的历史加密文档，通过预设密码库（如公司旧密码）尝试解密，提升数据可用性。
3. 安全审计：批量检测 PDF 密码强度，发现可被简单密码破解的文件时提示弱密码风险，推动密码加固。

示例C#代码如下：

using Spire.Pdf;public class PdfSecurityChecker
{public static void Main(){// 扫描指定文件夹中的每一个PDF文档string folderPath = @"F:\PDFs\";foreach (string file in Directory.GetFiles(folderPath, "*.pdf")){// 验证PDF文档是否加密bool isProtected = PdfDocument.IsPasswordProtected(file);Console.WriteLine($"{Path.GetFileName(file)} 是否加密: {isProtected}");// 如果是加密的PDF文档，逐一验证正确密码if (isProtected){TestPasswords(file, new[] { "default", "company_secret", "temp_pwd", "user123", "abc"});}}}// 验证正确的密码private static void TestPasswords(string filePath, string[] passwords){foreach (string pwd in passwords){if (ValidatePdfPassword(filePath, pwd)){Console.WriteLine($"  验证成功！密码: {pwd}");return;}}Console.WriteLine("  所有密码测试失败！");}static bool ValidatePdfPassword(string filePath, string password){// 用测试密码逐一打开PDF进行验证PdfDocument pdf = new PdfDocument();try{pdf.LoadFromFile(filePath, password);// 无异常 = 密码正确  return true;}catch (Exception){return false; // 密码错误  }finally{pdf.Close();}}
}

总结

本文详细介绍了使用Free Spire.PDF库通过C#检测PDF加密状态和测试密码的实用技术。关键点包括：

✅ 通过 IsPasswordProtected 方法检测加密状态

✅ 使用 LoadFromFile 方法用密码逐一加载PDF文档来测试密码有效性

✅ 实现对多个PDF文档的批量处理

希望本文中提供的示例能帮助你在日常工作中高效安全地处理加密PDF文档。