求可提取PPT中所有超链接（含文本与URL）的Java正确代码

错误原因分析 #

你的两段代码报错核心问题有三个：

1. API版本不匹配：旧版Apache POI中XSLFTextParagraph和XSLFTextRun没有getHyperlinks()（复数）方法，正确调用是getHyperlink()（单数），且仅文本运行对象支持该方法。
2. 遍历逻辑错误：第一段代码直接for (XSLFTextParagraph paragraph : textShape)属于非法遍历，需调用textShape.getTextParagraphs()获取段落列表。
3. 遗漏形状级超链接：PPT里的图片、普通形状本身也可能绑定超链接，你的代码没覆盖这类场景。

正确实现代码 #

以下适配Apache POI 4.x/5.x版本的完整代码，可提取文本内和形状本身的所有超链接：

import org.apache.poi.sl.usermodel.*;
import org.apache.poi.xslf.usermodel.*;

import java.io.FileInputStream;
import java.io.IOException;

public class PptxHyperlinkExtractor {
    public static void main(String[] args) {
        try (FileInputStream fis = new FileInputStream("file.pptx");
             XMLSlideShow ppt = new XMLSlideShow(fis)) {

            for (XSLFSlide slide : ppt.getSlides()) {
                // 处理形状本身的超链接（如图片、矩形等）
                for (XSLFShape shape : slide.getShapes()) {
                    Hyperlink<?> shapeLink = shape.getHyperlink();
                    if (shapeLink != null) {
                        String linkLabel = shape instanceof XSLFTextShape ? ((XSLFTextShape) shape).getText() : shape.getShapeName();
                        System.out.println("形状超链接 - 标签: " + linkLabel);
                        System.out.println("URL: " + shapeLink.getAddress());
                        System.out.println();
                    }

                    // 处理文本形状内的文本超链接
                    if (shape instanceof XSLFTextShape) {
                        XSLFTextShape textShape = (XSLFTextShape) shape;
                        for (XSLFTextParagraph paragraph : textShape.getTextParagraphs()) {
                            for (XSLFTextRun textRun : paragraph.getTextRuns()) {
                                Hyperlink<?> textLink = textRun.getHyperlink();
                                if (textLink != null) {
                                    String linkAddress = textLink.getAddress();
                                    String linkLabel = textRun.getRawText();
                                    System.out.println("文本超链接 - 标签: " + linkLabel);
                                    System.out.println("URL: " + linkAddress);
                                    System.out.println();
                                }
                            }
                        }
                    }
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

关键注意事项 #

• 依赖版本：确保使用Apache POI 4.1.2及以上版本，Maven依赖示例：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>

• 资源管理：用try-with-resources语法自动关闭文件流和PPT对象，避免资源泄漏。
• 场景覆盖：代码同时处理文本片段和形状本身的超链接，覆盖PPT中常见的超链接类型。

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