Apache POI复制Word页眉异常：图片丢失、格式错乱及内容不可读求助

你的问题出在直接通过setHeaderFooter复制另一个文档的页眉XML结构——Word的页眉依赖文档包内的资源（图片、样式定义、字体映射等），这些资源的引用ID是源文档独有的，直接复制XML会导致新文档无法找到对应资源，进而引发格式错乱、图片不显示和文档损坏报错。

正确解决思路 #

需要逐段复制页眉内容，并同步复制所有依赖资源，而不是直接复用源文档的XML节点。具体步骤：

• 遍历源页眉的所有段落，逐个复制到目标页眉
• 复制段落中的图片资源到目标文档的包内，并更新图片引用ID
• 同步段落和文本的样式格式

修正后的代码实现 #

import org.apache.poi.openxml4j.opc.PackagePart;
import org.apache.poi.xwpf.usermodel.*;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTP;

import java.io.*;
import java.util.Objects;

public class Main {
    public static void main(String[] args) throws IOException {
        try (XWPFDocument targetDoc = new XWPFDocument();
             XWPFDocument sourceDoc = loadHeader()) {

            if (sourceDoc == null) {
                System.err.println("无法加载源文档");
                return;
            }

            // 获取源页眉和创建目标页眉
            XWPFHeader sourceHeader = sourceDoc.getHeaderArray(0);
            XWPFHeader targetHeader = targetDoc.createHeader(HeaderFooterType.DEFAULT);

            // 复制页眉内容
            copyHeaderContent(sourceHeader, targetHeader);

            // 写入目标文档
            try (FileOutputStream out = new FileOutputStream("CreateWordHeader.docx")) {
                targetDoc.write(out);
            }
        }
    }

    private static XWPFDocument loadHeader() {
        try {
            return new XWPFDocument(Objects.requireNonNull(Main.class.getClassLoader()
                    .getResourceAsStream("Dok3.docx")));
        } catch (IOException e) {
            e.printStackTrace();
            return null;
        }
    }

    private static void copyHeaderContent(XWPFHeader source, XWPFHeader target) throws IOException {
        // 遍历源页眉的所有段落
        for (XWPFParagraph sourcePara : source.getParagraphs()) {
            // 在目标页眉创建新段落
            XWPFParagraph targetPara = target.createParagraph();
            // 复制段落的XML结构（包含格式）
            CTP sourceCTP = sourcePara.getCTP();
            targetPara.getCTP().set(sourceCTP);

            // 复制段落中的图片
            for (XWPFRun sourceRun : sourcePara.getRuns()) {
                for (XWPFPicture sourcePic : sourceRun.getEmbeddedPictures()) {
                    // 获取源图片的二进制数据
                    byte[] picData = sourcePic.getPictureData().getData();

                    // 在目标文档中添加图片并更新引用ID
                    String newBlipId = target.getDocument().addPictureData(
                            picData,
                            sourcePic.getPictureData().getPictureType()
                    );
                    sourcePic.getCTPicture().getBlipFill().getBlip().setEmbed(newBlipId);
                }
            }
        }
    }
}

关键细节说明 #

• 资源同步：图片存储在Word的OPC包中，必须将源图片的二进制数据复制到目标文档包，并更新图片的embed引用ID，否则Word无法找到图片资源。
• 段落复制：直接复制段落的CTP结构可以保留段落的格式（对齐方式、缩进、行距等），避免手动设置格式的繁琐。
• 自动关闭资源：使用try-with-resources语法自动关闭文档流，避免资源泄漏。

额外注意事项 #

如果源页眉包含自定义样式或编号列表，还需要额外复制样式定义到目标文档，否则样式会丢失或显示异常。可以通过XWPFStyles类同步样式集合。

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