spring boot应用中通过getresourceasstream()读取excel文件时会缓存旧数据，需改用file类实时读取磁盘文件，确保每次请求都返回最新内容。
spring boot应用中通过getresourceasstream()读取excel文件时会缓存旧数据，需改用file类实时读取磁盘文件，确保每次请求都返回最新内容。
在Spring Boot中实现Excel文件动态下载时，一个常见误区是使用 getClass().getResourceAsStream("/sample.xlsx") ——该方式从类路径（classpath） 加载资源，而类路径资源（如打包在JAR/WAR中的文件或IDE启动时加载的src/main/resources下的文件）在应用启动时即被JVM加载并缓存，后续文件系统中的更新不会自动生效。因此，即使你手动替换了服务器上的sample.xlsx，接口仍持续返回Tomcat启动时的旧版本。
正确做法是绕过类路径，直接通过java.io.File访问文件系统中的最新物理文件：
@GetMapping("/download")
public ResponseEntity<Resource> download() throws IOException {
// 指向服务器上可动态更新的绝对路径或相对路径（推荐使用绝对路径+配置化）
String filePath = "/var/data/sample.xlsx"; // Linux示例；Windows可为 "D:\data\sample.xlsx"
File file = new File(filePath);
if (!file.exists() || !file.canRead()) {
return ResponseEntity.status(HttpStatus.NOT_FOUND)
.body(ResourceUtils.getFile("classpath:static/404.html"));
}
Resource resource = new UrlResource(file.toURI());
String contentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"; // .xlsx
// 若为.xls，用 "application/vnd.ms-excel"
return ResponseEntity.ok()
.header(HttpHeaders.CONTENT_DISPOSITION,
"attachment; filename="" + file.getName() + """)
.contentType(MediaType.parseMediaType(contentType))
.contentLength(file.length())
.body(resource);
}✅ 关键改进说明：
tidy-excel-data
下载
清理、标准化、验证并汇总杂乱的 Excel 工作簿。当 Codex 需要处理 `.xlsx`、`.xls`、`.xlsm` 或 `.csv` 格式的数据时使用，包括：统一表头格式、删除空白行与空白列、修剪文本内容、去重记录、检测数据质量问题、拆分或合并工作表、生成清洗后的工作簿，以及为业务电子表格生成审计摘要。
- new File(filePath) 每次请求都重新构建文件句柄，真实读取磁盘当前状态；
- 使用 UrlResource 替代 IOUtils.toByteArray(is)，避免内存全量加载大文件，支持高效流式传输；
- 显式校验文件存在性与可读性，提升健壮性；
- 设置 Content-Length 有助于前端进度提示和浏览器正确处理下载。
⚠️ 注意事项：
- 确保应用进程对目标文件路径具有读取权限（尤其在Linux生产环境）；
- 生产中建议将路径外部化，例如通过 @Value("${excel.file.path:/var/data/sample.xlsx}") 配置；
- 避免将可变文件放在src/main/resources下——该目录属于构建产物，不适用于运行时动态更新；
- 如需更高可靠性（如多实例共享），应考虑对接NAS、对象存储（如MinIO/S3）或数据库BLOB，而非依赖本地文件系统。
综上，动态Excel下载的核心原则是：脱离类路径缓存，直连实时文件系统，并辅以资源抽象与异常防护。
