Apache POI解析docx时无法读取#name、#surname#占位符的问题求助

当前替换逻辑失效的核心是Apache POI 读取 docx 时，会将同一段落内存在格式差异（包括 Word 自动拆分的文本分段、拼写检查临时标记、输入过程中无意触发的格式分段）的内容拆分为多个独立的 XWPF Run 对象。
这种文本拆分是Word的常见行为，哪怕用户输入时没有主动调整格式，只要段落中间触发了自动拼写检查标记、输入法切换的微小格式差异，Word就会把连续文本拆分为多个独立Run。你提到的 #name#、#surname# 两个占位符，刚好被 Word 拆分成了多个独立 Run（比如拆为 #、name、# 三个文本块）。你的代码仅对单个 Run 内完全满足#开头、#结尾的文本做替换判断，自然无法扫描到跨 Run 的占位符；其余可正常替换的标签，是刚好完整存储在单个 Run 内，因此没有触发问题。

• 替换原有逐 Run 判断的逻辑，先按段落维度扫描全量文本：不再逐 Run 匹配占位符，而是将单个段落内所有 Run 的文本拼接为完整字符串，从段落全量文本中识别、替换所有符合 #xxx# 格式的占位符。
• 核心处理逻辑代码参考：

// 自定义替换映射，可扩展随机生成姓名、姓氏的逻辑
Map<String, String> replaceMap = new HashMap<>();
replaceMap.put("#name#", "随机生成的完整姓名");
replaceMap.put("#surname#", "随机生成的姓氏");

// 遍历文档正文段落
for (XWPFParagraph p : docx.getParagraphs()) {
    List<XWPFRun> runs = p.getRuns();
    if (runs == null || runs.isEmpty()) continue;

    // 拼接当前段落全量文本
    StringBuilder fullText = new StringBuilder();
    for (XWPFRun r : runs) {
        fullText.append(r.getText(0));
    }
    String originalParaText = fullText.toString();

    // 执行占位符精准替换
    String replacedParaText = originalParaText;
    for (Map.Entry<String, String> entry : replaceMap.entrySet()) {
        replacedParaText = replacedParaText.replace(entry.getKey(), entry.getValue());
    }

    // 文本无变化直接跳过，有变化则将替换结果放回段落，清空其余被拆分的Run
    if (!originalParaText.equals(replacedParaText)) {
        runs.get(0).setText(replacedParaText, 0);
        for (int i = 1; i < runs.size(); i++) {
            runs.get(i).setText("", 0);
        }
    }
}

• 将上述段落处理逻辑抽为公共方法，复用到表格单元格内的段落遍历流程中，不需要在表格循环里重复写逐 Run 判断的旧逻辑。
• 优化原有判断的兼容性：
  • 放弃原有“单个 Run 必须整个以#开头、以#结尾”的强匹配条件，避免占位符前后带空格、被拆分时完全匹配不到的问题
  • 修正原有 text.replace("#", "new ") 的写法：该逻辑会把占位符内所有#符号全部替换成new ，替换后的结果为new namenew ，不符合占位符替换的预期，直接按完整占位符字符串做精准替换即可。

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