将数据导出 Excel 并异步发送到指定邮箱：一次性能优化实战

脏唐臭汉邋遢宋 發表於 2025-5-9 14:28:00

将数据导出 Excel 并异步发送到指定邮箱：一次性能优化实战

使用 Spring Boot 实现 Excel 导出 + 邮件异步发送功能，解决接口阻塞问题
一、背景介绍 最近我在开发一个跑团管理系统的数据导出功能，需求是将用户查询的成员信息、跑量统计等数据导出为 Excel 文件，并通过邮件自动发送至指定邮箱，而非让用户手动下载文件。 虽然功能逻辑看起来不复杂，但在实际开发过程中遇到了一些关键性问题： 导出 Excel 后发送邮件耗时较长，导致接口响应延迟； QQ 邮箱 SMTP 校验严格，出现 550 The "From" header is missing or invalid 异常； 接口体验差，用户点击后需要等待很久才能收到响应。 于是我对整个流程进行了分析与重构，最终实现了高性能、高可用的数据导出 + 邮件发送功能。
 
 
二、功能实现流程概览 用户发起请求，选择导出类型（成员列表 / 跑量统计等）； 系统调用服务层获取数据； 使用 Apache POI 构建 Excel 文件并写入内存流（ByteArrayOutputStream）； 将生成的 Excel 字节数组作为附件，使用 JavaMailSender 发送邮件； 返回接口响应，提示邮件已发送成功（实则后台异步执行）；
 
三、遇到的问题与解决方案 ✅ 问题一：Excel 导出时报错 sheetName must not be null 原因： Apache POI 要求每个 Sheet 必须有名称，否则抛出异常。 解决方案： 在创建 ExcelUtil 实例后显式设置 sheetName，例如：
ExcelUtil<PersonalRunningGroupExportVO> util = new ExcelUtil<>(PersonalRunningGroupExportVO.class); util.setSheetName("跑团数据");
 
✅ 问题二：QQ 邮箱发送失败，报错 550 The "From" header is missing or invalid 原因： QQ 邮箱对发件人地址校验非常严格，要求 MAIL FROM 地址必须与登录账号一致，否则拒绝发送。 解决方案： 在邮件构建器中显式设置发件人地址:
MimeMessageHelper helper = new MimeMessageHelper(message, true); helper.setFrom("your-qq@qq.com"); // 必须与 spring.mail.username 一致
同时确保配置文件中使用的是授权码，而非登录密码：
<img src="https://img2024.cnblogs.com/blog/3353251/202505/3353251-20250509142227248-1058654527.png">
 
spring: mail: host: smtp.qq.com port: 587 username: your-qq@qq.com password: 授权码 properties: mail.smtp.auth: true mail.smtp.starttls.enable: true
 
✅ 问题三：发送邮件过程很慢，影响接口响应时间 原因： 邮件发送属于 I/O 操作，受网络、服务器限制，同步执行会阻塞主线程，影响用户体验。 解决方案： 引入 Spring 的异步任务支持 @Async，将邮件发送操作放入子线程处理。 步骤如下： 1.在启动类上添加 @EnableAsync 2.创建邮件服务类 EmailService，并在方法上添加 @Async 3.Controller 中调用异步方法发送邮件，立即返回结果
示例代码:
<img src="https://img2024.cnblogs.com/blog/3353251/202505/3353251-20250509142307534-563540067.png">
 
@Async public void sendExcelEmailAsync(String to, byte[] data, String fileName) { try { MimeMessage message = javaMailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(message, true); helper.setFrom("your-qq@qq.com"); helper.setTo(to); helper.setSubject("导出的跑团数据"); helper.setText("请查收附件中的跑团数据。"); helper.addAttachment(fileName + ".xlsx", new ByteArrayResource(data)); javaMailSender.send(message); } catch (Exception e) { log.error("邮件发送失败：{}", e.getMessage()); } }
四、优化效果 优化前 接口需等待邮件发送完成才返回 用户需等待 3~5 秒甚至超时 多次请求客易造成线程阻塞 QQ 邮箱频繁报错无法发送 优化后 接口立即返回，邮件后台异步发送 接口响应时间缩短至 300ms 内 支持并发发送，提升吞吐能力 设置 From 后成功发送，兼客性强
 
五、总结 这次开发让我深刻体会到： 邮件发送应尽量避免阻塞主线程，建议统一走异步化处理； Spring Boot 提供了强大的异步支持，只需简单配置即可使用； QQ 邮箱对发件人地址校验严格，务必保证 From 和 Username 一致； 使用 ByteArrayOutputStream 替代临时文件，更安全高效； 合理封装 ExcelUtil 工具类，提高复用性和可维护性。
 
六、完整功能点清单(便于读者参考) 功能模块                                                       技术点 数据导出                                                       Apache POl Excel写入内存　　　　　　　　　　　　ByteArrayOutputStream 邮件发送　　　　　　　　　　　　　　JavaMailSender/Jakarta Mail 异步处理　　　　　　　　　　　　@Async + ThreadPoolTaskExecutor 邮箱验证　　　　　　　　　　　　　　SMTP from 一致性校验 接口优化　　　　　　　　　　　　　　非阻塞响应设计 邮箱类型　　　　　　　　　　　　　QQ/Gmail/网易等通用适配 
七、结语 如果你也在做类似的数据导出 + 邮件通知功能，希望这篇文章能帮你少踩坑，快速上线稳定版本。如有疑问欢迎留言交流，也欢迎你分享你的优化思路！
 
来源：https://www.cnblogs.com/wecandoallthings/p/18868141

頁: [1]

琼殿技术论坛's Archiver

将数据导出 Excel 并异步发送到指定邮箱：一次性能优化实战