<!-- 核心：freemarker 依賴 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

    <!-- commons-io 依賴 -->
    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.11.0</version>
    </dependency>
    <!-- Hutool 工具類 -->
    <dependency>
      <groupId>cn.hutool</groupId>
      <artifactId>hutool-all</artifactId>
      <version>5.7.16</version>
    </dependency>
    <!-- easyExcel 導(dǎo)入導(dǎo)出工具類  -->
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>easyexcel</artifactId>
      <version>3.3.2</version>
    </dependency>
    <dependency>
      <groupId>cn.afterturn</groupId>
      <artifactId>easypoi-base</artifactId>
      <version>4.1.3</version>
    </dependency>
    <dependency>
      <groupId>cn.afterturn</groupId>
      <artifactId>easypoi-web</artifactId>
      <version>4.1.3</version>
    </dependency>
    <dependency>
      <groupId>cn.afterturn</groupId>
      <artifactId>easypoi-annotation</artifactId>
      <version>4.1.3</version>
    </dependency>

import cn.afterturn.easypoi.word.WordExportUtil;
import cn.hutool.core.lang.Assert;
import freemarker.template.Configuration;
import freemarker.template.Template;
import org.apache.commons.io.IOUtils;
import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.*;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.util.Base64;
import java.util.Map;
import java.util.Objects;

public class ExportWordUtils {

    private static final Logger LOGGER = LoggerFactory.getLogger(ExportWordUtils.class);

/**
     * 導(dǎo)出word（基于FreeMarker）
     *
     * @param dataMap      數(shù)據(jù)集
     * @param templateName 模板名稱
     * @param filePath     模板路徑
     * @param fileName     文件名
     * @param request      HttpServletRequest
     * @param response     HttpServletResponse
     */
    public static void exportDoc(Map<String, Object> dataMap, String templateName,
                                 String filePath, String fileName,
                                 HttpServletRequest request, HttpServletResponse response) {
        Assert.notNull(dataMap, "數(shù)據(jù)集不能為空");
        Assert.notNull(templateName, "模板名稱不能為空");
        Assert.notNull(filePath, "模板路徑不能為空");
        Assert.notNull(fileName, "文件名不能為空");

        Writer writer = null;
        try {
            Configuration config = new Configuration(Configuration.VERSION_2_3_30);
            config.setDefaultEncoding(StandardCharsets.UTF_8.name());
            config.setDirectoryForTemplateLoading(new File(filePath));

            Template template = config.getTemplate(templateName, StandardCharsets.UTF_8.name());

            String userAgent = getUserAgent(request);
            String encodedFileName = encodeFileName(fileName + ".doc", userAgent);

			response.setContentType("application/xml");
            response.setCharacterEncoding(StandardCharsets.UTF_8.name());
        	response.addHeader("Content-Disposition", "attachment;fileName=" + fileName);

            writer = new BufferedWriter(new OutputStreamWriter(response.getOutputStream(), StandardCharsets.UTF_8));
            template.process(dataMap, writer);
            writer.flush();
        } catch (Exception e) {
            LOGGER.error("導(dǎo)出Word文檔失敗，模板: {}", templateName, e);
            if (!response.isCommitted()) {
                response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            }
        } finally {
            IOUtils.closeQuietly(writer);
        }
    }
    /**
     * 獲取模板文件路徑
     * 兼容 Windows 和 Linux 系統(tǒng)
     *
     * @return 模板所在目錄的絕對路徑
     */
    public static String getTemplatePath() {
        try {
            String path = Objects.requireNonNull(
                            Thread.currentThread().getContextClassLoader().getResource("templates/word/"))
                    .getPath();
            return java.net.URLDecoder.decode(path, "UTF-8");
        } catch (Exception e) {
            LOGGER.error("獲取模板路徑失敗", e);
            throw new RuntimeException("獲取模板路徑失敗", e);
        }
    }

	private static String getUserAgent(HttpServletRequest request) {
        return request.getHeader("User-Agent");
    }

    private static String encodeFileName(String fileName, String userAgent) throws UnsupportedEncodingException {
        if (userAgent.contains("MSIE") || userAgent.contains("Trident")) {
            return URLEncoder.encode(fileName, "UTF-8");
        } else if (userAgent.contains("Firefox")) {
            return new String(fileName.getBytes(StandardCharsets.UTF_8), StandardCharsets.ISO_8859_1);
        } else {
            return URLEncoder.encode(fileName, "UTF-8");
        }
    }
}

@Slf4j
@RestController
public class TestController {

    private static final Logger LOGGER = LoggerFactory.getLogger(TestController.class);


	@GetMapping("/exportWord")
    public void exportWord(HttpServletResponse response, HttpServletRequest request) {

        String fileName = "測試單";
        Map<String, Object> dataMap = new HashMap<>();

        dataMap.put("year", String.valueOf(DateUtils.getCurrentYear()));
        dataMap.put("month", String.valueOf(DateUtils.getCurrentMonth()));
        dataMap.put("day", String.valueOf(DateUtils.getCurrentDay()));

        dataMap.put("name", "張三");
        dataMap.put("age", "20");
        dataMap.put("phone", "123456789");
        dataMap.put("address", "北京市東城區(qū)長安街北側(cè)");
        dataMap.put("hobby", "學習");

        String templatePath = ExportWordUtils.getTemplatePath();
        LOGGER.info("導(dǎo)出測試單，模板路徑: {}, 文件名: {}", templatePath, fileName);
				
		// 調(diào)用工具類導(dǎo)出 Word
        ExportWordUtils.exportDoc(dataMap, "test.ftl", templatePath, fileName, request, response);
    }
    
}