Mendix中Apache POI问题：克隆幻灯片修改同步至原幻灯片

在Mendix项目中使用Apache POI处理PowerPoint时，出现异常：克隆幻灯片后，文本替换操作意外修改了原模板幻灯片，但添加表格、更换图片等功能正常生效，仅文本替换出现此问题。

原因分析 #

• Apache POI的importContent方法在克隆幻灯片时，对文本段落（XSLFTextParagraph）和文本运行（XSLFTextRun）对象采用共享引用的方式，而非完全深拷贝。这意味着修改克隆幻灯片的TextRun时，实际操作的是原幻灯片的同一对象实例。
• 图片、表格等元素在克隆时会创建全新的对象实例，因此修改这些元素不会影响原幻灯片，这也解释了只有文本替换出问题的现象。

解决方案建议 #

方案1：修改文本替换逻辑，避免直接操作共享TextRun #

重构replaceTextInSlide方法，不直接修改原TextRun，而是重新构建文本内容，确保操作的是克隆幻灯片独立的文本对象：

private void replaceTextInSlide(XSLFSlide slide, Map<String, String> replacements) {
    for (XSLFShape shape : slide.getShapes()) {
        if (shape instanceof XSLFTextShape) {
            XSLFTextShape textShape = (XSLFTextShape) shape;
            for (XSLFTextParagraph paragraph : textShape.getTextParagraphs()) {
                // 收集并替换所有文本内容
                StringBuilder newContent = new StringBuilder();
                for (XSLFTextRun run : paragraph.getTextRuns()) {
                    String text = run.getRawText();
                    // 批量替换所有占位符
                    for (Map.Entry<String, String> entry : replacements.entrySet()) {
                        text = text.replace(entry.getKey(), entry.getValue());
                    }
                    newContent.append(text);
                }
                // 清空原段落，创建新的TextRun
                paragraph.clearText();
                XSLFTextRun newRun = paragraph.addNewTextRun();
                newRun.setText(newContent.toString());
                
                // 可选：复制原文本的样式（字体、大小、颜色等）
                if (!paragraph.getTextRuns().isEmpty()) {
                    XSLFTextRun originalRun = paragraph.getTextRuns().get(0);
                    newRun.setFontFamily(originalRun.getFontFamily());
                    newRun.setFontSize(originalRun.getFontSize());
                    newRun.setBold(originalRun.isBold());
                    newRun.setItalic(originalRun.isItalic());
                    newRun.setTextColor(originalRun.getTextColor());
                }
            }
        }
    }
}

方案2：提前断开原模板幻灯片的文本共享引用 #

在克隆前，对原模板幻灯片的文本内容做一次"刷新"，强制创建新的TextRun实例，后续克隆时就不会共享原对象：

// 获取templateSlide后添加这段代码
XSLFSlide templateSlide = mainPpt.getSlides().get(0);
// 断开原幻灯片的文本共享引用
for (XSLFShape shape : templateSlide.getShapes()) {
    if (shape instanceof XSLFTextShape) {
        XSLFTextShape textShape = (XSLFTextShape) shape;
        for (XSLFTextParagraph paragraph : textShape.getTextParagraphs()) {
            String originalText = paragraph.getText();
            paragraph.clearText();
            paragraph.addNewTextRun().setText(originalText);
        }
    }
}

方案3：手动实现幻灯片深拷贝（彻底规避共享问题） #

如果上述方案无法满足需求，可以手动逐个复制原幻灯片的所有元素，确保每个元素都是独立实例。这种方式需要处理文本、图片、表格等所有形状类型，代码量较大，但能彻底解决共享引用问题。

内容的提问来源于stack exchange，提问作者Łukasz Walczak