Java本地文件定期清理核心是准确判断过期（lastModified()或文件名时间戳）和可靠定时触发（ScheduledExecutorService或@Scheduled），并需权限校验、空值防护、最小保留数及预览模式等安全机制。
Java 实现本地文件定期清理过期策略，核心是两件事：一是准确判断文件是否过期（基于最后修改时间或文件名中嵌入的时间戳），二是用可靠方式触发周期性执行（避免依赖外部调度时出错）。关键不在“怎么删”，而在“什么时候删、删得安全不误删”。
根据最后修改时间判断过期
最常用也最稳妥的方式是用 File.lastModified() 获取毫秒时间戳，与当前时间比对。例如保留最近 7 天的文件：
long expireThreshold = System.currentTimeMillis() - 7L * 24 * 60 * 60 * 1000;
File dir = new File("/path/to/logs");
for (File file : dir.listFiles()) {
if (file.isFile() && file.lastModified() < expireThreshold) {
if (file.delete()) {
System.out.println("Deleted: " + file.getName());
}
}
}注意：listFiles() 可能返回 null（目录不存在或无权限），需判空；删除前建议先 file.canWrite() 检查写权限；生产环境推荐用 Files.deleteIfExists()（NIO.2）替代 delete()，异常更明确。
用 ScheduledExecutorService 实现定时触发
避免用 Timer（易受任务执行时间影响导致错漏），改用线程池式调度：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
ScheduledExecutorService scheduler = Executors.newSingleThreadScheduledExecutor();
// 每天凌晨 2 点执行一次
scheduler.scheduleAtFixedRate(() -> {
cleanExpiredFiles("/path/to/logs", 7);
}, initialDelay(), 1, TimeUnit.DAYS);其中 initialDelay() 可计算为距下次凌晨 2 点的毫秒数，确保首次执行不跳过。若应用是 Spring Boot，直接用 @Scheduled(cron = "0 0 0 2 * ?") 更简洁，底层也是基于 ScheduledExecutorService。
按文件名时间戳解析过期（适合归档命名规范场景）
当文件名含日期（如 app-20240520.log 或 backup_2024-05-20.tar.gz），可避免依赖系统时间被篡改的风险：
- 用正则提取日期部分，例如
Pattern.compile("app-(\d{8})\.log") - 解析为
LocalDate，再与当前日期比较是否超过 N 天 - 优先匹配完整路径+文件名，防止误匹配子目录名或日志内容
这种方式更适合日志轮转、备份文件等人为控制命名的场景，鲁棒性更高。
清理前加安全防护机制
线上误删不可逆，务必加入保护层：
- 配置开关：通过配置项（如
cleanup.enabled=true）控制是否真正删除 - 预览模式：首次运行只打印将要删除的文件列表，确认无误后再启用真实删除
- 保留最小数量：即使全过期，也至少保留 3 个最新文件，防配置失误清空所有
- 记录日志：每条删除操作记入独立 cleanup.log，含时间、文件路径、大小，便于审计
不复杂但容易忽略。
