Spring Boot 应用中通过 getResourceAsStream() 读取 Excel 文件时会缓存类路径资源，导致始终返回应用启动时的旧数据；应改用 File 实例直接访问文件系统，确保每次请求都读取最新内容。
spring boot 应用中通过 `getresourceasstream()` 读取 excel 文件时会缓存类路径资源，导致始终返回应用启动时的旧数据；应改用 `file` 实例直接访问文件系统，确保每次请求都读取最新内容。
在 Spring Boot 中实现 Excel 文件的动态下载，关键在于避免类路径资源的静态缓存行为。你当前代码使用 this.getClass().getResourceAsStream("/sample.xlsx")，该方法从 classpath（如 src/main/resources 或打包后的 JAR 内部）加载资源——而 JVM 在首次调用时会将该资源内容缓存，后续请求不再重新读取磁盘，因此即使文件已更新，返回的仍是 Tomcat 启动时加载的“快照”。
✅ 正确做法：使用 java.io.File 直接访问文件系统中的真实路径，确保每次请求都实时读取最新文件：
tidy-excel-data
下载
清理、标准化、验证并汇总杂乱的 Excel 工作簿。当 Codex 需要处理 `.xlsx`、`.xls`、`.xlsm` 或 `.csv` 格式的数据时使用，包括：统一表头格式、删除空白行与空白列、修剪文本内容、去重记录、检测数据质量问题、拆分或合并工作表、生成清洗后的工作簿，以及为业务电子表格生成审计摘要。
@GetMapping("/download")
public ResponseEntity<Resource> download() throws IOException {
// 假设 Excel 文件位于服务器文件系统固定路径，例如：/var/data/sample.xlsx
File file = new File("/var/data/sample.xlsx"); // ✅ 动态读取，无缓存
if (!file.exists() || !file.canRead()) {
return ResponseEntity.status(HttpStatus.NOT_FOUND)
.body(ResourceUtils.getFile("classpath:static/not-found.xlsx"));
}
Resource resource = new UrlResource(file.toURI());
String contentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"; // .xlsx
if (file.getName().toLowerCase().endsWith(".xls")) {
contentType = "application/vnd.ms-excel"; // .xls
}
return ResponseEntity.ok()
.header(HttpHeaders.CONTENT_DISPOSITION,
"attachment; filename=\"" + file.getName() + "\"")
.contentType(MediaType.parseMediaType(contentType))
.body(resource);
}? 重要注意事项：
- ✅ 路径必须是绝对路径或相对于应用运行目录的可靠相对路径（如 new File("sample.xlsx") 默认基于 JVM 启动目录）。建议使用配置项（如 @Value("${excel.path:/var/data/sample.xlsx}")）提升可维护性。
- ❌ 避免将 Excel 放在 src/main/resources 下并通过 getResourceAsStream() 读取——该方式适用于只读静态资源（如模板、配置），不适用于需频繁更新的业务文件。
- ⚠️ 若部署在容器（Docker）或云环境，请确保目标路径已挂载且应用有读取权限；生产环境推荐配合 Nginx 静态文件服务或对象存储（如 S3）提升性能与可靠性。
- ? 进阶优化：可添加 Last-Modified 响应头与 If-Modified-Since 支持协商缓存，减少重复传输。
通过切换为 File 实例读取，你彻底绕过了类加载器的资源缓存机制，真正实现了“按需加载最新 Excel 数据”，这是构建可维护、可更新的文件服务的基础实践。
