如何用iText 7.1.8检测PDF表单中的锁定字段？

嘿，我来帮你搞定这个iText 7检测PDF锁定字段的问题！

首先先给你的代码做个小优化：你当前用到了PdfWriter，但如果只是检测字段而不需要修改PDF的话，完全不需要写入器，只读打开文档就够了，这样更高效还能避免不必要的文件操作。

核心逻辑分成两步走就好：

1. 判断PDF里是否存在Acro表单
2. 遍历表单字段，检查是否有锁定（只读）字段

完整实现代码 #

public boolean hasLockedFields(final String pdfPath) {
    // 用try-with-resources自动关闭资源，避免内存泄漏
    try (PdfReader pdfReader = new PdfReader(new FileInputStream(pdfPath));
         PdfDocument doc = new PdfDocument(pdfReader)) {
        
        // 获取Acro表单，第二个参数false表示：如果没有表单则返回null，不创建新表单
        PdfAcroForm form = PdfAcroForm.getAcroForm(doc, false);
        
        // 第一步：判断是否存在表单
        if (form == null) {
            System.out.println("该PDF没有可编辑的Acro表单");
            return false;
        }
        
        // 获取所有表单字段
        Collection<PdfFormField> fields = form.getFields();
        
        // 第二步：遍历字段，检查是否有只读（锁定）字段
        for (PdfFormField field : fields) {
            // iText封装的isReadOnly()方法会自动检查字段本身或父级的只读设置
            if (field.isReadOnly()) {
                System.out.println("找到锁定字段：" + field.getFieldName());
                return true;
            }
            // 额外检查：是否有通过数字签名锁定的字段
            PdfObject lockObj = field.getPdfObject().get(PdfName.Lock);
            if (lockObj != null) {
                System.out.println("找到签名锁定字段：" + field.getFieldName());
                return true;
            }
        }
        
        // 遍历完所有字段都没有锁定的
        System.out.println("该PDF表单中没有锁定字段");
        return false;
        
    } catch (IOException e) {
        e.printStackTrace();
        // 处理文件读取异常，比如文件不存在、权限不足等
        return false;
    }
}

关键细节说明 #

• 资源管理：用try-with-resources包裹PdfReader和PdfDocument，确保资源自动关闭，不会出现内存泄漏问题。
• 表单存在性判断：PdfAcroForm.getAcroForm(doc, false)如果返回null，说明PDF里没有Acro表单，直接返回false即可。
• 锁定字段检测：
  • field.isReadOnly()是iText封装好的方法，会自动检查字段自身的READ_ONLY标志，以及父级字段组的只读继承设置；
  • 额外添加的PdfName.Lock检查，是针对通过数字签名锁定的字段场景，覆盖更多锁定情况。
• 异常处理：捕获IOException，处理文件读取时的各种意外情况（比如文件找不到、无法打开等）。

内容的提问来源于stack exchange，提问作者John