Java导出Excel文件无后缀名问题成因及修复方法咨询

1. MIME类型配置错误：代码中定义的CONTENT_TYPE值为multipart/form-data，这是用于表单提交的媒体类型，而非.xlsx格式Excel的专属MIME类型。操作系统、浏览器识别文件类型时会优先读取MIME标识，配置错误会导致系统无法识别这是Excel文件，自动去掉扩展名判定为普通文件。
2. 下载场景缺少响应头配置：如果该方法是用于Web接口返回文件下载，仅在MockMultipartFile中传入带扩展名的文件名是不够的，需要显式在HTTP响应头中配置Content-Disposition属性，告知客户端完整的文件名和格式，否则部分框架会自动丢弃文件名后缀。
3. 临时文件清理问题（次要）：当前代码使用File.createTempFile生成临时文件，但没有手动删除逻辑，长期运行会占用服务器磁盘空间。

第一步：修正MIME类型配置 #

将原有常量修改为正确的xlsx文件MIME类型：

// 原错误配置
// private static final String CONTENT_TYPE = "multipart/form-data";
// 修正后的xlsx文件MIME类型
private static final String CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";

第二步：Web下载场景补充响应头配置 #

如果是Spring Boot等Web框架提供下载接口，不要直接返回MultipartFile，直接将 workbook 写入响应流即可，完整示例：

@GetMapping("/exportExcel")
public void exportExcel(HttpServletResponse response, UUID uuid) throws IOException {
    XSSFWorkbook workbook = new XSSFWorkbook();
    // 原有生成Excel的逻辑不变，省略中间代码

    // 设置响应头
    response.setContentType(CONTENT_TYPE);
    String fileName = URLEncoder.encode(FILE_NAME + FILE_EXTENSION, StandardCharsets.UTF_8.name());
    response.setHeader("Content-Disposition", "attachment;filename=" + fileName);
    
    // 直接写入响应流，不需要生成临时文件
    try(ServletOutputStream out = response.getOutputStream()) {
        workbook.write(out);
        out.flush();
    } finally {
        workbook.close();
    }
}

第三步：必须返回MultipartFile的场景优化 #

如果业务逻辑要求必须返回MultipartFile，补充临时文件删除逻辑，避免磁盘泄漏：

public MultipartFile export(final UUID uuid) throws IOException {
    // 原有生成Excel逻辑不变
    final File outputFile = File.createTempFile(FILE_NAME, FILE_EXTENSION);
    try (FileOutputStream outputStream = new FileOutputStream(outputFile)) {
        workbook.write(outputStream);
    } catch (IOException e) {
        LoggingUtils.error("error... ", e);
    } finally {
        workbook.close();
    }

    try (FileInputStream input = new FileInputStream(outputFile)) {
        final String fileName = FILE_NAME.concat(FILE_EXTENSION);
        MultipartFile file = new MockMultipartFile(fileName, fileName, CONTENT_TYPE, IOUtils.toByteArray(input));
        // 用完立即删除临时文件
        outputFile.delete();
        return file;
    }
}

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