使用Apache POI替换Word关键词仅生效一次的问题排查

问题根源 #

你的代码仅替换一个关键词就停止运行，核心原因是循环逻辑错误：在遍历Word段落的for循环内部执行了y = y + 1，导致处理完第一个段落就直接推进了关键词索引y，外层的while (y < numOfQuestions)循环提前结束。此外，每次处理段落就写入文件的操作既低效又可能引发文件损坏问题。

修复后的完整代码 #

public static void processDRDocument(String[] fileLocation) {
    try {
        // 读取Excel文件
        InputStream ExcelFileToRead = new FileInputStream(fileLocation[0]);
        XSSFWorkbook workbook = new XSSFWorkbook(ExcelFileToRead);
        XSSFSheet sheet = workbook.getSheet("DocumentInforma");

        // 读取问题和答案数组
        int numOfQuestions = sheet.getRow(0).getLastCellNum();
        String[] question = new String[numOfQuestions];
        String[] answer = new String[numOfQuestions];
        int x = 0;
        int y = 0;
        int z = 1;
        while (y < numOfQuestions) {
            question[y] = "[[" + sheet.getRow(x).getCell(y).getStringCellValue() + "]]";
            answer[y] = sheet.getRow(z).getCell(y).getStringCellValue();
            y++;
        }

        // 读取Word文档
        FileInputStream fis = new FileInputStream(fileLocation[3]);
        XWPFDocument xdoc = new XWPFDocument(OPCPackage.open(fis));

        // 遍历所有关键词，逐个替换文档中的内容
        y = 0;
        while (y < numOfQuestions) {
            String targetKey = question[y];
            String replacement = answer[y];

            // 遍历文档中所有段落
            for (XWPFParagraph p : xdoc.getParagraphs()) {
                List<XWPFRun> runs = p.getRuns();
                if (runs != null) {
                    for (XWPFRun r : runs) {
                        String text = r.getText(0);
                        if (text != null && text.contains(targetKey)) {
                            // 替换关键词
                            text = text.replace(targetKey, replacement);
                            r.setText(text, 0);
                            System.out.println("替换后文本：" + text);
                        }
                    }
                }
            }
            // 处理完一个关键词后，再推进索引
            y++;
        }

        // 所有替换完成后，统一写入输出文件
        try (FileOutputStream fos = new FileOutputStream("output2.docx")) {
            xdoc.write(fos);
        }

        // 关闭资源
        xdoc.close();
        workbook.close();
        fis.close();
        ExcelFileToRead.close();

    } catch (Exception ex) {
        ex.printStackTrace();
    }
}

关键修改点 #

• 调整循环逻辑：将y = y + 1移到外层while循环的末尾，确保一个关键词完全遍历完所有段落和Run后，再处理下一个关键词。
• 统一文件写入：删除段落循环内的文件写入操作，所有替换完成后一次性写入，避免重复IO和文件损坏风险。
• 优化资源管理：使用try-with-resources自动关闭输出流，确保资源正确释放。
• 冗余代码清理：移除了无用的BufferedReader和遍历Excel行的冗余代码块（原代码中这部分仅遍历但未做实际处理）。

额外注意事项 #

• 如果Word文档中的关键词被拆分到多个XWPFRun中（比如[[Who和 is...]]分属不同Run），当前代码无法识别，需要额外处理Run合并逻辑，确保完整匹配关键词。
• 确保Excel中的问题名称与Word中的[[关键词]]完全一致（包括空格、标点），否则匹配会失败。

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