如何在不创建新XWPFRun的情况下将其修改为超链接？

错误原因分析 #

你遇到的java.lang.ArrayIndexOutOfBoundsException是因为XWPFRun.setText(String value,int pos)的第二个参数pos是文本在当前Run内的插入位置索引，必须小于Run现有文本的长度。但你传入的i是原Run在段落中的索引，数值远大于Run内文本的长度，直接触发数组越界。另外，你用insertNewHyperlinkRun是在创建新的Run对象，完全违背了“不创建新XWPFRun”的需求。

正确实现思路 #

要将现有XWPFRun转为超链接，无需新建Run，直接给现有Run绑定超链接关系即可。Word中的超链接本质是通过Run关联文档的超链接关系实现的，POI的XWPFRun本身支持直接关联超链接ID，不需要单独创建XWPFRunHyperlink。

修改后的代码实现 #

private void updateRunsForParagraph1(XWPFParagraph p, String text, String key, Map<String, String> hyperlinkMap, Map<String, List<Boolean>> singleWordMap,SBCFormatDocument sbcFormatDocumentObj) throws IOException {
    for (int i = 0; i < p.getRuns().size(); i++) {
        try {
            XWPFRun targetRun = p.getRuns().get(i);
            // 用getText(0)获取Run的真实文本，避免toString()返回对象字符串的问题
            String tmpText = targetRun.getText(0); 

            if (tmpText != null && tmpText.equalsIgnoreCase(text)) {
                String[] subText = text.split(" ");
                for (String word : subText) {
                    if (hyperlinkMap.containsKey(word)) {
                        XWPFDocument doc = p.getDocument();
                        String linkUrl = hyperlinkMap.get(word);
                        
                        // 创建超链接关系并绑定到当前Run
                        XWPFHyperlink hyperlink = doc.createHyperlink();
                        hyperlink.setURL(linkUrl);
                        targetRun.getCTR().getRPr().addNewHyperlink().setId(hyperlink.getId());
                        
                        // 设置超链接的默认样式：蓝色字体+单下划线
                        targetRun.setColor("0000FF");
                        targetRun.setUnderline(UnderlinePatterns.SINGLE);
                        
                        // 替换Run文本为目标单词（根据需求调整，若需保留原文本可跳过此步骤）
                        targetRun.setText(word, 0);
                    }
                }
                break;
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

关键注意点 #

1. 获取Run文本的正确方式：用targetRun.getText(0)替代toString()，后者返回的是Run对象的字符串表示，不是真实文本内容。
2. 超链接关联逻辑：通过XWPFHyperlink创建文档级的超链接关系，再将Run的CTR对象关联该超链接的ID，实现现有Run的超链接绑定。
3. 样式适配：手动设置蓝色字体和下划线，模拟Word默认超链接样式。
4. 部分文本超链接的限制：Word的超链接是基于Run的，若要将Run中的部分文本转为超链接，必须拆分出多个Run（无法在单个Run内实现部分超链接），这会违背你“不创建新Run”的要求，因此仅适用于整个Run文本转为超链接的场景。

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