如何在Java与Apache POI中创建无弃用警告的Selenium测试超链接

你遇到的问题核心是Apache POI在版本迭代中对超链接API做了重大调整：旧的基于int常量（比如Hyperlink.LINK_FILE）的超链接类型定义，以及对应的createHyperlink(int)方法，在3.17正式版中被彻底移除——这也是你升级到新版POI后出现“LINK_FILE无法解析”错误的原因；而更早的beta版还只是保留旧API并给出弃用警告，没有彻底移除。

下面是针对不同场景的解决方案：

一、适配新版POI（3.17正式版及以后）的标准写法 #

直接使用POI提供的新枚举类HyperlinkType和对应的重载方法，同时建议用通用的Hyperlink接口而非具体实现类（比如HSSFHyperlink），让代码兼容xls和xlsx两种格式：

// 从当前Workbook实例获取CreationHelper（必须和你的Excel文件类型匹配）
CreationHelper createHelper = workbook.getCreationHelper();

// 创建指向本地文件的超链接，使用HyperlinkType.FILE枚举
Hyperlink link = createHelper.createHyperlink(HyperlinkType.FILE);
// 建议把本地路径转为标准URI格式，避免Windows路径分隔符导致的链接失效
link.setAddress(new File(screenshotURL).toURI().toString());
hyperlinkList.add(link);

二、兼容新旧POI版本的过渡方案 #

如果因为项目依赖限制需要同时兼容旧版（比如3.17 beta）和新版POI，可以通过异常捕获做兼容处理（仅作为临时过渡，建议尽快迁移到新版API）：

CreationHelper createHelper = workbook.getCreationHelper();
Hyperlink link;

try {
    // 优先尝试新版API
    link = createHelper.createHyperlink(HyperlinkType.FILE);
} catch (NoSuchMethodError | IllegalArgumentException e) {
    // 回退到旧版弃用API，添加SuppressWarnings消除警告
    @SuppressWarnings("deprecation")
    Hyperlink oldLink = createHelper.createHyperlink(Hyperlink.LINK_FILE);
    link = oldLink;
}

link.setAddress(new File(screenshotURL).toURI().toString());
hyperlinkList.add(link);

三、额外注意事项 #

• 确保CreationHelper是从你正在操作的Workbook实例中获取的，不要单独实例化，否则会出现兼容性问题。
• 本地文件路径转为URI格式后，Excel能更稳定地识别超链接，避免因为系统差异（比如Windows的\和Linux的/）导致链接失效。

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