NAS上删除看似非空文件夹异常：Windows Explorer打开时删除失败

问题场景 #

用Java在NAS上删除文件/文件夹时，常规操作正常，但当Windows资源管理器打开待删除文件夹时会出现异常：

例如文件夹A包含文件夹B，尝试先删除B再删除A，B会被删除，但A无法删除。代码检测显示A仍非空，还存在B文件夹，但Windows资源管理器中已看不到B（已开启显示隐藏文件）。本地运行该代码时，即使打开Windows资源管理器也能正常删除，仅在NAS上出现此问题。

用户提供的代码：

boolean isSuccessfullyRemoved;
void test(){
    isSuccessfullyRemoved = true;
    Path p = Paths.get("FOLDER B");
    try (def ds = Files.newDirectoryStream(p)) {
        ds.each { subPath ->
            // Delete every files in the folder B
            if (subPath.toFile().isFile()) {
                deleteFileorFolder(subPath);
            }
        }
    }

    // The folder B should be empty if the deletion of the files was successful and does not contains a folder
    if (isSuccessfullyRemoved && isDirEmpty(p)) {
        // Delete Folder B
        deleteFileorFolder(p);

        // Folder B has been deleted, isSuccessfullyRemoved is TRUE but isDirEmpty is FALSE, why?
        if (isSuccessfullyRemoved && isDirEmpty(p.parent)) {
            deleteFileorFolder(p.parent);
        }
    }
}

boolean isDirEmpty(Path directory) {
    try (def ds = Files.newDirectoryStream(directory)) {
        return !ds.iterator().hasNext();
    }
}

void deleteFileorFolder(Path p) {
    try {
        Files.delete(p);
    } catch (ignored) {
        isSuccessfullyRemoved = false;
    }
}

问题根源分析 #

1. NAS文件系统缓存/延迟：NAS多基于SMB/NFS等网络文件系统，Windows资源管理器打开文件夹时会持有目录句柄，NAS侧可能不会立即同步删除状态，导致Java读取目录时仍能看到已删除文件夹的残留条目。
2. 代码逻辑缺陷：原代码仅删除文件夹B中的文件，未递归处理B内的子文件夹；且删除B后直接判断A是否为空，未考虑NAS文件系统的状态同步延迟。
3. 文件句柄未释放：Windows资源管理器打开B时，NAS侧可能仍持有该目录的句柄，导致B的删除仅为标记删除，未真正释放目录资源，Java读取时仍能感知到残留。

解决思路 #

1. 实现递归删除逻辑 #

修改删除方法，递归处理文件夹下所有文件和子文件夹，确保目标文件夹被彻底清空后再删除：

void deleteFileOrFolder(Path p) {
    try {
        if (Files.isDirectory(p)) {
            // 先递归删除所有子项
            try (DirectoryStream<Path> ds = Files.newDirectoryStream(p)) {
                for (Path subPath : ds) {
                    deleteFileOrFolder(subPath);
                }
            }
        }
        Files.delete(p);
    } catch (Exception e) {
        isSuccessfullyRemoved = false;
        // 打印异常便于排查是否是文件被占用
        e.printStackTrace();
    }
}

2. 添加目录空状态校验的重试机制 #

针对NAS文件系统的同步延迟，删除后等待一段时间再校验目录状态，或多次重试：

boolean isDirEmptyWithRetry(Path directory, int retryCount, long delayMs) {
    for (int i = 0; i < retryCount; i++) {
        try (DirectoryStream<Path> ds = Files.newDirectoryStream(directory)) {
            if (!ds.iterator().hasNext()) {
                return true;
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 等待后重试
        try {
            Thread.sleep(delayMs);
        } catch (InterruptedException ignored) {
            Thread.currentThread().interrupt();
        }
    }
    // 最后一次校验
    try (DirectoryStream<Path> ds = Files.newDirectoryStream(directory)) {
        return !ds.iterator().hasNext();
    } catch (Exception e) {
        e.printStackTrace();
        return false;
    }
}

使用时替换原isDirEmpty方法，例如：

if (isSuccessfullyRemoved && isDirEmptyWithRetry(p.parent, 3, 500)) {
    deleteFileOrFolder(p.parent);
}

3. 针对性处理文件占用异常 #

在删除方法中不要忽略所有异常，捕获具体的IOException，判断是否为文件/目录被占用的情况，可针对性提示用户关闭资源管理器：

void deleteFileOrFolder(Path p) {
    try {
        // 递归删除逻辑...
        Files.delete(p);
    } catch (IOException e) {
        isSuccessfullyRemoved = false;
        // 判断是否是文件被占用的错误（不同NAS可能错误码不同）
        if (e.getMessage().contains("being used by another process") || e instanceof FileSystemException) {
            System.out.println("目标目录被占用，请关闭Windows资源管理器后重试");
        }
        e.printStackTrace();
    }
}

4. 调用NAS原生删除命令（可选） #

如果Java API受限于网络文件系统特性，可尝试调用NAS系统的原生删除命令（如Linux的rm -rf），通过ProcessBuilder执行，绕过Java API的缓存限制：

void deleteViaNativeCommand(Path p) {
    try {
        ProcessBuilder pb = new ProcessBuilder("rm", "-rf", p.toString());
        Process process = pb.start();
        int exitCode = process.waitFor();
        if (exitCode != 0) {
            isSuccessfullyRemoved = false;
            System.out.println("原生命令删除失败");
        }
    } catch (Exception e) {
        isSuccessfullyRemoved = false;
        e.printStackTrace();
    }
}

内容的提问来源于stack exchange，提问作者Lougs