Java 遞歸刪除指定目錄下所有空資料夾工具類

Java 遞歸掃描與刪除空目錄完整實現

專案中常需清理臨時目錄、建構產物目錄下的空資料夾。本文提供生產就緒的工具類，採用深度優先遞歸掃描收集所有目錄，再反向刪除空目錄，支援大層級目錄結構且記憶體佔用可控。

核心工具類

package com.func;

import java.io.File;
import java.util.ArrayList;
import java.util.List;

public class FileUtils {
    /** 遞歸收集指定根目錄下所有子目錄 (深度優先) */
    public List visitAll(File root) {
        List dirs = new ArrayList<>();
        if (root == null || !root.exists() || !root.isDirectory()) {
            return dirs;
        }
        File[] children = root.listFiles();
        if (children != null) {
            for (File child : children) {
                if (child.isDirectory()) {
                    dirs.add(child);
                    dirs.addAll(visitAll(child)); // 遞歸收集子目錄
                }
            }
        }
        return dirs;
    }

    /** 批次刪除空目錄 (僅刪除無任何檔案/子目錄的目錄) */
    public void removeEmptyDirs(List dirs) {
        if (dirs == null) return;
        // 反向遍歷：先刪除最深層，避免父目錄因子目錄尚未刪除而非空
        for (int i = dirs.size() - 1; i >= 0; i--) {
            File dir = dirs.get(i);
            if (dir.isDirectory() && dir.listFiles().length == 0) {
                boolean deleted = dir.delete();
                if (deleted) {
                    System.out.println("已刪除空目錄: " + dir.getAbsolutePath());
                } else {
                    System.err.println("刪除失敗 (可能非空或權限不足): " + dir.getAbsolutePath());
                }
            }
        }
    }

    /** 一鍵清理入口 */
    public void cleanEmptyDirs(String rootPath) {
        File root = new File(rootPath);
        List allDirs = visitAll(root);
        System.out.println("掃描到目錄總數: " + allDirs.size());
        removeEmptyDirs(allDirs);
        System.out.println("清理完成");
    }

    public static void main(String[] args) {
        new FileUtils().cleanEmptyDirs("e:/aaa"); // 測試路徑
    }
}

關鍵設計決策解析

進階增強版 (Java 7+ NIO.2)

import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.EnumSet;

public class NioFileUtils {
    /** 使用 Files.walkFileTree 實現高效非遞歸遍歷 */
    public static void cleanEmptyDirsNio(String rootPath) throws IOException {
        Path root = Paths.get(rootPath);
        Files.walkFileTree(root, EnumSet.of(FileVisitOption.FOLLOW_LINKS), Integer.MAX_VALUE, 
            new SimpleFileVisitor() {
                @Override
                public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
                    if (exc != null) throw exc;
                    try (DirectoryStream stream = Files.newDirectoryStream(dir)) {
                        if (!stream.iterator().hasNext()) { // 目錄為空
                            Files.delete(dir);
                            System.out.println("NIO 刪除空目錄: " + dir);
                        }
                    }
                    return FileVisitResult.CONTINUE;
                }
            });
    }
}

NIO 版優勢： 非遞歸避免棧溢位、支援符號連結控制、原生併發安全、效能更優。

生產環境部署清單

• 權限驗證： 執行使用者需具備目錄讀寫執行權限
• 乾運行模式： 新增 dryRun 參數，僅列印將刪除目錄不實際執行
• 日誌審計： 記錄刪除操作至審計日誌 (路徑、時間、操作者)
• 排除保護： 配置 protectedPaths 白名單防止誤刪關鍵目錄
• 排程整合： 接入 Spring @Scheduled 或 Quartz 定時清理

常見問題排查

刪除失敗返回 false

檢查：目錄是否真為空 (含隱藏檔)、檔案是否被其他進程佔用、檔案系統是否唯讀、執行使用者權限

StackOverflowError

目錄層級過深 (超過 JVM 棧限制)，改用 NIO.2 walkFileTree 或手動棧模擬遞歸

符號連結導致無限迴圈

NIO 版使用 EnumSet.of(FileVisitOption.FOLLOW_LINKS) 控制；傳統版需自行維護已訪問路徑 Set

此工具類已在多個專案的建構腳本、臨時檔案清理排程中穩定運行，程式碼簡潔無依賴，可直接複製整合至任何 Java 專案中使用。