<!-- EasyExcel 核心依賴 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
  	<version>4.0.3</version>
</dependency>
<!-- ZIP 壓縮依賴（處理多文件打包） -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-compress</artifactId>
    <version>1.27.1</version>
</dependency>
<!-- Spring Web 依賴（已有則忽略，接口開發(fā)必備） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

/**
 * 用戶列表 Excel 對應(yīng)的實(shí)體類
 */
@Data
public class UserData {
    // Excel 表頭：用戶ID
    @ExcelProperty("用戶ID")
    private Long userId;

    // Excel 表頭：用戶名稱
    @ExcelProperty("用戶名稱")
    private String userName;

    // Excel 表頭：手機(jī)號
    @ExcelProperty("手機(jī)號")
    private String phone;
}

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

/**
 * 訂單列表 Excel 對應(yīng)的實(shí)體類
 */
@Data
public class OrderData {
    // Excel 表頭：訂單ID
    @ExcelProperty("訂單ID")
    private String orderId;

    // Excel 表頭：用戶ID（關(guān)聯(lián)用戶表）
    @ExcelProperty("用戶ID")
    private Long userId;

    // Excel 表頭：訂單金額
    @ExcelProperty("訂單金額")
    private Double amount;

    // Excel 表頭：創(chuàng)建時間
    @ExcelProperty("創(chuàng)建時間")
    private String createTime;
}

import com.alibaba.excel.EasyExcel;
import org.apache.commons.compress.archivers.zip.ZipArchiveEntry;
import org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream;

import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.ByteArrayOutputStream;
import java.net.URLEncoder;
import java.util.List;

/**
 * EasyExcel 多文件導(dǎo)出 ZIP 工具類（通用可復(fù)用）
 */
public class ExcelZipExportUtil {

    /**
     * 將單個 Excel 文件寫入 ZIP 輸出流
     * @param zipOut ZIP 輸出流
     * @param excelFileName 單個 Excel 的文件名（如：用戶列表.xlsx）
     * @param data Excel 中的數(shù)據(jù)列表
     * @param clazz Excel 對應(yīng)的實(shí)體類（用于解析表頭）
     */
    public static <T> void writeExcelToZip(ZipArchiveOutputStream zipOut, String excelFileName,
                                           List<T> data, Class<T> clazz) throws Exception {
        // 1. 臨時存儲 Excel 內(nèi)容（內(nèi)存級，不寫入磁盤，性能更高）
        ByteArrayOutputStream bos = new ByteArrayOutputStream();
        // 2. 使用 EasyExcel 寫入數(shù)據(jù)（sheet1 是工作表名稱，可自定義）
        EasyExcel.write(bos, clazz)
          			// 不要自動關(guān)閉，交給 Servlet 自己處理
                .autoCloseStream(false) 
          			// 基于 column 長度，自動適配。最大 255 寬度
                .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy()) 
          			// 避免 Long 類型丟失精度
                .registerConverter(new LongStringConverter()) 
          			// 工作表名稱
                .sheet("sheet1") 
                .doWrite(data);

        // 3. 將 Excel 作為 ZIP 的一個條目寫入
        zipOut.putArchiveEntry(new ZipArchiveEntry(excelFileName));
        zipOut.write(bos.toByteArray());
        zipOut.closeArchiveEntry(); // 關(guān)閉當(dāng)前 ZIP 條目（必須，否則后續(xù)條目無法寫入）

        // 4. 關(guān)閉臨時流
        bos.close();
    }

    /**
     * 初始化 HTTP 響應(yīng)頭（設(shè)置 ZIP 下載、解決中文文件名亂碼）
     * @param response 響應(yīng)對象
     * @param zipFileName 最終下載的 ZIP 壓縮包名稱（如：用戶訂單數(shù)據(jù).zip）
     */
    public static void initZipResponse(HttpServletResponse response, String zipFileName) throws Exception {
        // 設(shè)置響應(yīng)類型為 ZIP
        response.setContentType("application/zip");
        // 設(shè)置下載頭，URLEncoder.encode 解決中文文件名亂碼（兼容所有瀏覽器）
        response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(zipFileName, "UTF-8"));
        // 禁止緩存（避免瀏覽器緩存舊文件）
        response.setHeader("Pragma", "no-cache");
        response.setHeader("Cache-Control", "no-cache");
    }
}

import org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import java.util.ArrayList;
import java.util.List;

/**
 * Excel 導(dǎo)出接口控制器
 */
@RestController
@RequestMapping("/export")
public class ExcelExportController {

    /**
     * 單個接口導(dǎo)出兩個 Excel 文件（打包成 ZIP 下載）
     * 訪問地址：http://localhost:8080/export/twoExcel
     */
    @GetMapping("/twoExcel")
    public void exportTwoExcel(HttpServletResponse response) {
        try {
            // 1. 初始化響應(yīng)頭，設(shè)置 ZIP 壓縮包名稱（用戶下載時顯示的文件名）
            ExcelZipExportUtil.initZipResponse(response, "用戶訂單數(shù)據(jù).zip");
            // 2. 獲取 HTTP 響應(yīng)輸出流，關(guān)聯(lián) ZIP 輸出流
            ServletOutputStream servletOut = response.getOutputStream();
            ZipArchiveOutputStream zipOut = new ZipArchiveOutputStream(servletOut);

            // 3. 構(gòu)造第一個 Excel 的數(shù)據(jù)（用戶列表，實(shí)際項(xiàng)目中替換為數(shù)據(jù)庫查詢）
            List<UserData> userList = new ArrayList<>();
            // 3.1 完善數(shù)據(jù)邏輯省略

            // 4. 構(gòu)造第二個 Excel 的數(shù)據(jù)（訂單列表，實(shí)際項(xiàng)目中替換為數(shù)據(jù)庫查詢）
            List<OrderData> orderList = new ArrayList<>();
						// 4.1 完善數(shù)據(jù)邏輯省略

            // 5. 關(guān)鍵操作：將兩個 Excel 分別寫入 ZIP 流
            ExcelZipExportUtil.writeExcelToZip(zipOut, "用戶列表.xlsx", userList, UserData.class);
            ExcelZipExportUtil.writeExcelToZip(zipOut, "訂單列表.xlsx", orderList, OrderData.class);

            // 6. 關(guān)閉流（順序不能錯！否則 ZIP 包會損壞，無法解壓）
            zipOut.finish(); // 完成 ZIP 寫入
            zipOut.close();
            servletOut.flush();
            servletOut.close();

        } catch (Exception e) {
            e.printStackTrace();
            // 實(shí)際項(xiàng)目中建議自定義異常處理，給前端返回明確的錯誤提示
            response.setStatus(500);
        }
    }
}

// 新增商品列表數(shù)據(jù)（假設(shè)已有 GoodsData 實(shí)體類）
List<GoodsData&gt; goodsList = new ArrayList<>();
// ... 構(gòu)造商品數(shù)據(jù)

// 新增一個 Excel 寫入 ZIP 流
ExcelZipExportUtil.writeExcelToZip(zipOut, "商品列表.xlsx", goodsList, GoodsData.class);