本文介绍使用 groovy 高效、安全地将单个文件压缩为 zip 并自动删除源文件的最佳实践，涵盖资源自动关闭、内存友好流式复制、异常安全性及路径处理等关键要点。
本文介绍使用 groovy 高效、安全地将单个文件压缩为 zip 并自动删除源文件的最佳实践，涵盖资源自动关闭、内存友好流式复制、异常安全性及路径处理等关键要点。
在 Groovy 中实现“压缩后删除原文件”看似简单，但需兼顾健壮性、内存效率与资源管理。原始代码存在几个典型问题：手动管理 ZipOutputStream 生命周期易引发资源泄漏；一次性读入全部字节到内存限制了可处理文件大小；delete() 调用未置于成功压缩后的安全位置；且未对非文件类型（如目录或不存在路径）做前置校验。
以下是优化后的专业实现，充分利用 Groovy 语言特性提升可读性与可靠性：
import java.util.zip.*
class ZipUtility {
/**
* 将指定文件压缩为同目录下的 ZIP 文件，并可选删除原文件
* @param fileToZip 待压缩的 File 对象（必须是普通文件）
* @param cleanUp 是否在压缩成功后删除原文件
* @return 成功时返回生成的 ZIP 文件对象；失败或输入非法时返回 null
*/
File createZipFile(File fileToZip, boolean cleanUp = false) {
if (!fileToZip?.isFile()) {
println "[WARN] Skipping: '${fileToZip?.absolutePath}' is not a valid file"
return null
}
// 构建 ZIP 文件路径：与原文件同目录，名称追加 ".zip"
File zipFile = new File(fileToZip.parentFile, "${fileToZip.name}.zip")
try {
// 使用 withCloseable 确保 ZipOutputStream 在任何情况下（含异常）均被关闭
new ZipOutputStream(new FileOutputStream(zipFile)).withCloseable { zipStream ->
zipStream.putNextEntry(new ZipEntry(fileToZip.name))
// 利用 Groovy 的 << 操作符流式复制，零内存缓冲，支持超大文件
fileToZip.withInputStream { inputStream ->
zipStream << inputStream
}
zipStream.closeEntry()
}
// 只有 ZIP 写入完全成功后才执行删除（此时 zipFile 已落盘且校验通过）
if (cleanUp && zipFile.exists() && zipFile.length() > 0) {
if (!fileToZip.delete()) {
throw new IOException("Failed to delete original file: ${fileToZip.absolutePath}")
}
println "[INFO] Original file deleted: ${fileToZip.name}"
}
return zipFile
} catch (IOException e) {
// 清理残留 ZIP 文件（避免部分写入的损坏文件残留）
if (zipFile.exists()) zipFile.delete()
throw new RuntimeException("Failed to create ZIP for ${fileToZip.name}", e)
}
}
}关键改进说明：
- ✅ 资源安全：withCloseable 替代手动 close()，彻底规避因异常导致的流未关闭问题；
- ✅ 内存高效：
- ✅ 路径健壮：显式使用 fileToZip.parentFile 构建 ZIP 路径，确保 ZIP 严格生成于源文件所在目录，避免相对路径歧义；
- ✅ 删除时机精准：delete() 仅在 withCloseable 正常退出后执行，且增加 ZIP 文件存在性与非空校验，防止误删；
- ✅ 错误防御：捕获 IOException 后主动清理临时 ZIP 文件，并抛出带上下文的运行时异常，便于调试；
- ✅ 语义清晰：方法签名明确参数类型（File），默认参数 cleanUp = false 提升 API 可预测性。
使用示例：
def util = new ZipUtility()
def source = new File("/tmp/data.txt")
// 仅压缩（不删除）
def zip1 = util.createZipFile(source)
// 压缩并删除原文件
def zip2 = util.createZipFile(source, true)
println "ZIP created: ${zip2.absolutePath}"⚠️ 注意事项：
- 该工具仅支持单文件压缩；如需压缩目录，请扩展逻辑遍历子项并递归添加 ZipEntry；
- 生产环境建议增加 ZIP 校验（如解压验证或 CRC32 核对）；
- 若需原子性保障（即“全成功或全失败”），可先写入临时 ZIP，校验通过后再重命名为目标名并删除原文件。
此方案平衡了 Groovy 的简洁性与 Java 的严谨性，是文件归档自动化任务中的推荐实践。
