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

news2025/7/24 16:35:35

引言：为什么需要检测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();
                }
            }
        }
    }
}

输出结果：

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

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

企业文档管理：批量检测加密 PDF 并尝试常用密码（如部门默认密码），解决密码遗忘导致的文档访问问题。
数据恢复：针对恢复出的历史加密文档，通过预设密码库（如公司旧密码）尝试解密，提升数据可用性。
安全审计：批量检测 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();
        }
    }
}