alibaba/nacos · error · IOException

Failed to list contents of {}

Error message

Failed to list contents of {}

What it means

Error "Failed to list contents of {}" thrown in alibaba/nacos.

Source

Thrown at common/src/main/java/com/alibaba/nacos/common/utils/IoUtils.java:263

     *
     * @param directory directory
     * @throws IOException io exception
     */
    public static void cleanDirectory(File directory) throws IOException {
        if (!directory.exists()) {
            String message = directory + " does not exist";
            throw new IllegalArgumentException(message);
        }
        
        if (!directory.isDirectory()) {
            String message = directory + " is not a directory";
            throw new IllegalArgumentException(message);
        }
        
        File[] files = directory.listFiles();
        // null if security restricted
        if (files == null) {
            throw new IOException("Failed to list contents of " + directory);
        }
        
        IOException exception = null;
        for (File file : files) {
            try {
                delete(file);
            } catch (IOException ioe) {
                exception = ioe;
            }
        }
        
        if (null != exception) {
            throw exception;
        }
    }
    
    /**
     * Judge whether is Gzip stream.

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Inspect the server logs for the underlying cause, fix it, and retry the operation.

When it happens

Trigger: Thrown at common/src/main/java/com/alibaba/nacos/common/utils/IoUtils.java:263 when the library encounters an invalid state.

Common situations: Listing a directory that cannot be read (permissions or I/O error).

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/61005945df28e086. Report an issue: GitHub.