使用apache-poi生成的Excel超链接点击跳转登录页如何修复

问题根源 #

你遇到的现象是微软Office的超链接跳转机制导致的，和Apache POI的超链接写入逻辑无关：

• Excel点击超链接时，会先用内置的HTTP引擎（默认走IE/Edge兼容内核）发送一次HEAD请求探测链接可用性，这个请求不会携带普通浏览器中已存储的会话Cookie、鉴权Token等凭证
• 服务端收到无有效会话的请求后，会返回302跳转至登录页，Excel会直接把跳转后的登录页地址传递给系统默认浏览器打开，所以最终呈现的是登录页面
• 你手动复制链接到浏览器打开时，是在已经登录过的浏览器上下文发起请求，会携带有效凭证，因此可以正常访问目标页面

修复方案 #

方案1：服务端适配（最稳妥，推荐） #

在服务端的鉴权拦截逻辑中新增特殊判定：
如果请求为HEAD方法，且请求头User-Agent包含Microsoft Office相关特征，直接返回200状态码，不做登录校验、不返回跳转响应。
Excel拿到200响应后，会把原始的目标URL传递给浏览器打开，此时就会携带正常的浏览器会话凭证，可正常访问。

方案2：修正代码错误 #

你当前代码存在多余的URL编码操作：对完整URL调用URLEncoder.encode会把://、?、&等URL分隔符也转义为编码字符，会导致URL识别异常，直接删除编码逻辑即可：

final CellStyle hlink_style = wb.createCellStyle();
final Font hlink_font = wb.createFont();
hlink_font.setUnderline(Font.U_SINGLE);
hlink_font.setColor(IndexedColors.DARK_BLUE.getIndex());
hlink_style.setFont(hlink_font);
        
// sample value
String value = "<a href=\"https://localhost/user/UserDetailAction.do?userid=213&depid=453\"></a>";
final Document document = Jsoup.parse((String) value);
final String id= document.select("a").first().text();
final String url = document.select("a").first().attr("href");

final Hyperlink hyperlink = wb.getCreationHelper().createHyperlink(1);
// 移除多余的编码操作，直接使用原始url
hyperlink.setAddress(url);
cell.setHyperlink(hyperlink);
cell.setCellStyle(hlink_style);
cell.setCellValue(id);

方案3：客户端本地规避（仅适合自用） #

如果不想修改服务端和代码，可修改本地Office注册表关闭超链接探测：

• 打开注册表编辑器，定位到路径HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\Internet（16.0对应Office2016/2019/365，其他版本替换为对应版本号即可）
• 新建DWORD类型值，名称为ForceShellExecute，数值设为1，重启Office后生效

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