本文详解 Spring Boot 中通过 ByteArrayResource 下载 Outlook 邮件文件（.msg）时，如何准确设置 Content-Type 和 Content-Disposition 响应头，避免文件名被错误解析为 .vnd.ms-outlook 后缀，确保浏览器正确识别并保存为 .msg 文件。
本文详解 spring boot 中通过 bytearrayresource 下载 outlook 邮件文件（.msg）时，如何准确设置 content-type 和 content-disposition 响应头，避免文件名被错误解析为 `.vnd.ms-outlook` 后缀，确保浏览器正确识别并保存为 `.msg` 文件。
在 Web 应用中提供 .msg（Microsoft Outlook 邮件存档）文件下载时，仅正确设置 MIME 类型（application/vnd.ms-outlook）并不足够——客户端（尤其是浏览器）依赖 Content-Disposition 响应头中的文件名扩展名来决定默认保存行为和关联应用。若该头中未显式包含 .msg 后缀，部分浏览器（如 Chrome、Edge）会将 filename=testFile 解析为无扩展名，再根据 Content-Type 自动补全不规范的后缀（如 testFile.vnd.ms-outlook），导致无法双击打开邮件内容。
✅ 正确做法：显式指定带扩展名的 filename，并使用 attachment 模式
Content-Disposition 头必须满足两个关键点：
- 使用
attachment（而非document或inline），明确指示浏览器下载而非内嵌显示； -
filename参数值需完整包含.msg扩展名，且建议用英文双引号包裹，以兼容含空格或特殊字符的文件名。
同时，推荐直接返回 byte[]（Spring 会自动包装为 ByteArrayResource），代码更简洁且语义清晰：
@GetMapping("/get/s3-file/{s3StorageId}")
public ResponseEntity<byte[]> downloadDocumentFromS3(@PathVariable String s3StorageId) {
DocumentResult storageResult = s3Service.getDocument(s3StorageId);
// 确保 contentType 来源可信；若 storageResult.getContentType() 可能为空或不准确，建议兜底
String mimeType = Optional.ofNullable(storageResult.getContentType())
.filter(ct -> !ct.trim().isEmpty())
.orElse("application/vnd.ms-outlook");
String originalFilename = storageResult.getFileName();
String safeFilename = (originalFilename != null && !originalFilename.isEmpty())
? originalFilename : "email.msg";
// 关键：filename 必须含 .msg 扩展名，且使用 attachment 模式
String contentDisposition = "attachment; filename=\"" + safeFilename + "\"";
return ResponseEntity.ok()
.contentType(MediaType.parseMediaType(mimeType))
.header(HttpHeaders.CONTENT_DISPOSITION, contentDisposition)
.contentLength(storageResult.getResult().length)
.body(storageResult.getResult());
}⚠️ 注意事项
-
不要依赖浏览器自动推断扩展名：即使 MIME 类型正确，缺失
.msg后缀仍会导致保存异常； -
避免硬编码文件名：生产环境应优先使用
storageResult.getFileName()，并做安全校验（如过滤路径遍历字符..、控制长度、限制非法字符）； -
MIME 类型容错处理：S3 元数据可能未正确设置
contentType，建议对null或空值提供默认值application/vnd.ms-outlook； -
中文/特殊字符文件名：如需支持，应使用
filename*=UTF-8''{encoded}格式（RFC 5987），但多数场景下 ASCII 文件名 +.msg已足够可靠。
正确配置后，用户点击下载将获得标准 xxx.msg 文件，可直接用 Outlook 或支持 .msg 的邮件客户端（如 Thunderbird + MsgViewer 插件）打开查看原始邮件结构、附件及格式化内容。
