<!-- Apache POI dependencies -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>org.apache.xmlbeans</groupId>
    <artifactId>xmlbeans</artifactId>
    <version>3.1.0</version>
</dependency>
<!-- Apache POI dependencies for OOXML (.docx) -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml-schemas</artifactId>
    <version>4.1.2</version>
</dependency>
<!-- Apache POI dependencies for OLE2 (.doc) -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-scratchpad</artifactId>
    <version>4.1.2</version>
</dependency>

Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Handler dispatch failed; nested exception is java.lang.NoSuchFieldError: Factory] with root cause

@RestController
@RequestMapping("/word")
public class DocumentWordController {
    @PostMapping("/uploadAndReplaceWord")
    public String uploadAndReplace(@RequestParam("file") MultipartFile file,
                                   @RequestParam Map<String, String> replacements) {
        // MultipartFile 接口的方法之一，返回上傳文件的內(nèi)容類型（MIME 類型）
        String contentType = file.getContentType();
        // 保存修改后的文檔
        String outputPath = "C:\\*****\\*****\\*****\\result";

        try {
            if (contentType != null && contentType.equals("application/msword")) {
                // 處理 .doc 文件
                HWPFDocument document = new HWPFDocument(file.getInputStream());
                replacePlaceholdersInDoc(document, replacements);
                outputPath += ".doc";
                try (FileOutputStream out = new FileOutputStream(outputPath)) {
                    document.write(out);
                }
            } else if (contentType != null && contentType.equals("application/vnd.openxmlformats-officedocument.wordprocessingml.document")) {
                // 處理 .docx 文件
                XWPFDocument document = new XWPFDocument(file.getInputStream());
                replacePlaceholdersInDocx(document, replacements);
                outputPath += ".docx";
                try (FileOutputStream out = new FileOutputStream(outputPath)) {
                    document.write(out);
                }
            } else {
                return "文件類型不支持：" + contentType;
            }

            return "文檔處理完成，保存至：" + outputPath;

        } catch (IOException e) {
            e.printStackTrace();
            return "文檔處理失敗";
        }
    }
    // 處理 .doc 文件
    // HWPFDocument類沒有與XWPFParagraph和XWPFRun類似的結(jié)構(gòu)化方法來逐段處理文檔
    // 所以需要使用HWPFDocument和相關(guān)的類Range和Paragraph來處理
    private void replacePlaceholdersInDoc(HWPFDocument document, Map<String, String> replacements) {
        // Range對象表示W(wǎng)ord文檔中的一段文本范圍
        // document.getRange()方法返回整個文檔的范圍，包括所有段落、表格、標(biāo)題等內(nèi)容
        Range range = document.getRange();
        // 遍歷替換映射中的每個鍵值對，并將文本塊中的占位符替換為指定的值，entry.getKey() 是占位符（如${name}）
        for (Map.Entry<String, String> entry : replacements.entrySet()) {
            // 替換范圍內(nèi)的文本：在整個文本內(nèi)找到所有匹配entry.getKey()的文本，并用entry.getValue()替換它們
            range.replaceText(entry.getKey(), entry.getValue());
        }
    }

    // 處理 .docx 文件
    private void replacePlaceholdersInDocx(XWPFDocument document, Map<String, String> replacements) {
        // 對文檔所有的段落做遍歷
        for (XWPFParagraph paragraph : document.getParagraphs()) {
            // 獲取段落中的文本塊
            // 每個段落 (XWPFParagraph) 由一個或多個文本塊 (XWPFRun) 組成，文本塊是段落中的最小文本單位，可以包含格式化信息（如字體、顏色）。
            List<XWPFRun> runs = paragraph.getRuns();
            // 若包含文本塊，對其做處理
            if (runs != null) {
                for (XWPFRun run : runs) {
                    // 獲取文本塊中的文本內(nèi)容，參數(shù)0表示獲取文本塊中的第一段文本（注：通常只有一段文本）
                    String text = run.getText(0);
                    if (text != null) {
                        // 創(chuàng)建StringBuilder處理字符串替換操作，提高性能，減少 String 對象的創(chuàng)建和銷毀
                        StringBuilder textBuilder = new StringBuilder(text);
                        // 遍歷替換映射中的每個鍵值對，并將文本塊中的占位符替換為指定的值，entry.getKey() 是占位符（如${name}）
                        // 使用 StringBuilder 的 indexOf 方法找到占位符的位置，并使用 replace 方法進(jìn)行替換
                        // 循環(huán)確保所有出現(xiàn)的占位符都被替換
                        for (Map.Entry<String, String> entry : replacements.entrySet()) {
                            int index = textBuilder.indexOf(entry.getKey());
                            while (index != -1) {
                                // replace 方法的參數(shù)分別是開始索引、結(jié)束索引和替換內(nèi)容
                                textBuilder.replace(index, index + entry.getKey().length(), entry.getValue());
                                // 將其移動到剛替換的文本的末尾
                                index += entry.getValue().length();
                                // 從當(dāng)前索引 index 開始繼續(xù)查找下一個占位符，若找到下一個占位符，更新 index 為新位置
                                // 若找不到，index 將為 -1，循環(huán)結(jié)束
                                index = textBuilder.indexOf(entry.getKey(), index);
                            }
                        }
                        // 將替換后的文本重新設(shè)置到文本塊中
                        run.setText(textBuilder.toString(), 0);
                    }
                }
            }
        }
    }
}