引言：为什么需要检测PDF加密状态？
在批量文档处理系统（如 OCR 文字识别、内容提取、格式转换）中，加密 PDF 无法直接操作。检测加密状态可提前筛选文件，避免流程因密码验证失败而中断。
本文使用 Free Spire.PDF for .NET（一个免费的.NET PDF处理库），演示如何通过C# 检测PDF是否加密，并验证密码的正确性。
目录
[Free Spire.PDF for .NET简介](#Free Spire.PDF for .NET简介)
[C# 检测PDF文档是否加密](# 检测PDF文档是否加密)
[C# 测试PDF正确密码](# 测试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#代码如下：
cs
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#代码如下：
cs
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();
}
}
}
}
}输出结果：
批量检测+密码测试 （完整企业级解决方案）：
对于需要批量处理文档应用场景，如：
- 企业文档管理：批量检测加密 PDF 并尝试常用密码（如部门默认密码），解决密码遗忘导致的文档访问问题。
- 数据恢复：针对恢复出的历史加密文档，通过预设密码库（如公司旧密码）尝试解密，提升数据可用性。
- 安全审计：批量检测 PDF 密码强度，发现可被简单密码破解的文件时提示弱密码风险，推动密码加固。
示例C#代码如下：
cs
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文档。