如何用Apache PDFBox提取PDF中的超链接及对应URL？

你的代码只处理了最标准的PDAnnotationLink类型链接，但实际PDF里的超链接可能有多种实现方式，导致你提取不到结果。下面是几种常见原因和对应的解决方法：

1. 链接动作被包装在动作容器中 #

有些PDF的链接动作不会直接是PDActionURI，而是被包含在PDActionSequence（动作序列）或其他动作容器里。原代码直接强转成PDActionURI会跳过这类情况，需要递归检查动作：

添加一个辅助方法来递归获取URI动作：

private static PDActionURI getURIAction(PDAction action) {
    if (action == null) return null;
    if (action instanceof PDActionURI) {
        return (PDActionURI) action;
    } else if (action instanceof PDActionSequence) {
        for (PDAction subAction : ((PDActionSequence) action).getActions()) {
            PDActionURI uriAction = getURIAction(subAction);
            if (uriAction != null) return uriAction;
        }
    }
    // 还可以扩展处理PDActionGoToR等其他可能包含URI的动作类型
    return null;
}

然后在原代码中替换强转的部分，用这个方法获取：

// 替换原代码中的PDActionURI action = (PDActionURI) link.getAction();
PDAction action = link.getAction();
PDActionURI uriAction = getURIAction(action);
if (uriAction != null) {
    String url = uriAction.getURI();
    System.out.println("URL: " + url);
}

2. 链接不是通过注解实现的 #

部分PDF的超链接是通过**结构树（Structure Tree）**绑定的，而非传统的链接注解。这种情况需要遍历文档的结构元素来提取：

添加结构树遍历的方法（示例简化，实际需递归处理所有子元素）：

private static void extractLinksFromStructureTree(PDDocument document) {
    if (document.getDocumentCatalog().getStructureTreeRoot() == null) return;
    document.getDocumentCatalog().getStructureTreeRoot().getKids().forEach(structElem -> {
        checkStructureElementForLinks(structElem);
    });
}

private static void checkStructureElementForLinks(Object structElem) {
    if (structElem instanceof PDStructureElement) {
        PDStructureElement elem = (PDStructureElement) structElem;
        PDAction action = elem.getAction();
        PDActionURI uriAction = getURIAction(action);
        if (uriAction != null) {
            System.out.println("结构树提取到URL: " + uriAction.getURI());
        }
        // 递归处理子元素
        elem.getKids().forEach(subElem -> checkStructureElementForLinks(subElem));
    }
}

在主循环中调用这个方法：

// 页面注解遍历完成后调用
extractLinksFromStructureTree(document);

3. PDF文件存在格式问题或隐藏注解 #

• 先验证PDF是否有损坏或非标准格式：

PDFValidator validator = new PDFValidator(document);
validator.validate();
List<ValidationResult.ValidationError> errors = validator.getValidationErrors();
if (!errors.isEmpty()) {
    System.err.println("PDF验证错误：");
    errors.forEach(error -> System.err.println("- " + error.getErrorMessage()));
}

• 打印所有注解类型，排查是否有被忽略的链接相关注解：

for (PDAnnotation annotation : annotations) {
    System.out.println("注解类型：" + annotation.getClass().getName());
    // 原注解判断逻辑...
}

修改后的完整代码 #

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotation;
import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationLink;
import org.apache.pdfbox.pdmodel.interactive.action.PDAction;
import org.apache.pdfbox.pdmodel.interactive.action.PDActionSequence;
import org.apache.pdfbox.pdmodel.interactive.action.PDActionURI;
import org.apache.pdfbox.pdmodel.structure.PDStructureElement;
import org.apache.pdfbox.validation.PDFValidator;
import org.apache.pdfbox.validation.ValidationResult;

import java.io.FileInputStream;
import java.io.IOException;
import java.util.List;

public class PDFLinkExtractor {
    public static void main(String[] args) {
        String filepath = "你的PDF文件路径.pdf";
        try (FileInputStream fis = new FileInputStream(filepath);
             PDDocument document = PDDocument.load(fis)) {

            // 验证PDF格式
            PDFValidator validator = new PDFValidator(document);
            validator.validate();
            List<ValidationResult.ValidationError> errors = validator.getValidationErrors();
            if (!errors.isEmpty()) {
                System.err.println("发现PDF格式问题：");
                errors.forEach(error -> System.err.println("- " + error.getErrorMessage()));
            }

            List<PDPage> pages = document.getPages();
            for (PDPage page : pages) {
                System.out.println("\n===== 第" + (pages.indexOf(page)+1) + "页 =====");
                List<PDAnnotation> annotations = page.getAnnotations();
                System.out.println("页内注解数量：" + annotations.size());

                // 遍历页面注解
                for (PDAnnotation annotation : annotations) {
                    System.out.println("当前注解类型：" + annotation.getClass().getName());
                    if (annotation instanceof PDAnnotationLink) {
                        PDAnnotationLink link = (PDAnnotationLink) annotation;
                        PDAction action = link.getAction();
                        PDActionURI uriAction = getURIAction(action);
                        if (uriAction != null) {
                            System.out.println("提取到URL: " + uriAction.getURI());
                        }
                    }
                }

                // 遍历结构树
                extractLinksFromStructureTree(document);
            }

        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private static PDActionURI getURIAction(PDAction action) {
        if (action == null) return null;
        if (action instanceof PDActionURI) {
            return (PDActionURI) action;
        } else if (action instanceof PDActionSequence) {
            for (PDAction subAction : ((PDActionSequence) action).getActions()) {
                PDActionURI uriAction = getURIAction(subAction);
                if (uriAction != null) return uriAction;
            }
        }
        return null;
    }

    private static void extractLinksFromStructureTree(PDDocument document) {
        if (document.getDocumentCatalog().getStructureTreeRoot() == null) {
            System.out.println("文档无结构树");
            return;
        }
        document.getDocumentCatalog().getStructureTreeRoot().getKids().forEach(structElem -> {
            checkStructureElementForLinks(structElem);
        });
    }

    private static void checkStructureElementForLinks(Object structElem) {
        if (structElem instanceof PDStructureElement) {
            PDStructureElement elem = (PDStructureElement) structElem;
            PDAction action = elem.getAction();
            PDActionURI uriAction = getURIAction(action);
            if (uriAction != null) {
                System.out.println("结构树提取到URL: " + uriAction.getURI());
            }
            // 递归处理子元素
            elem.getKids().forEach(subElem -> checkStructureElementForLinks(subElem));
        }
    }
}

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