apache/cassandra · error · IllegalStateException

Cannot write to an empty path

Error message

Cannot write to an empty path

What it means

File's toPathForWrite() guards all write-path operations (open output streams, create/delete variants) against a File carrying a null path, throwing IllegalStateException since there is nothing to write to. This surfaces from File constructors/factories that leave path unset (e.g. File.empty()).

Source

Thrown at src/java/org/apache/cassandra/io/util/File.java:793

        return new FileOutputStreamPlus(this, mode);
    }

    public FileInputStreamPlus newInputStream() throws NoSuchFileException
    {
        return new FileInputStreamPlus(this);
    }

    public File withSuffix(String suffix)
    {
        if (path == null)
            throw new IllegalStateException("Cannot suffix an empty path");
        return new File(path.getParent().resolve(path.getFileName().toString() + suffix));
    }

    private Path toPathForWrite()
    {
        if (path == null)
            throw new IllegalStateException("Cannot write to an empty path");
        return path;
    }

    private Path toPathForRead()
    {
        if (path == null)
            throw new IllegalStateException("Cannot read from an empty path");
        return path;
    }

    @VisibleForTesting
    public static FileSystem unsafeGetFilesystem()
    {
        return filesystem;
    }

    public static void unsafeSetFilesystem(FileSystem fs)
    {

View on GitHub (pinned to 88fd0f6a0e)

Solutions

1. Initialize the File with an actual path before any write operation — trace where the pathless instance came from.
2. Guard writes with if (file.path() != null) or an explicit Objects.requireNonNull check earlier in the flow.
3. Replace sentinel File.empty() usage with Optional<File> or a null-checked field.

Example fix

// before
out = file.newOutputStream();
// after
if (file.path() == null) throw new IllegalStateException("File not initialized before write");
out = file.newOutputStream();

if (file.path() == null) throw new IllegalStateException("Refusing to write to pathless File");

static boolean isWritable(File f) { return f != null && f.path() != null; }

try { out = file.newOutputStream(); }
catch (IllegalStateException e) { logger.error("Write on uninitialized File"); throw e; }

When it happens

Trigger: Attempting to write to, create, or delete a File created via File.empty() or another pathless construction — e.g. calling file.newOutputStream(), file.delete(), or parentOf-style operations on a placeholder instance.

Common situations: Code paths where a File field was never assigned before use; using File.empty() as a sentinel and accidentally writing to it; initialization-order bugs in descriptors/handlers.

Understand the failure class

Background: "failed to write file", "Could not save figure", "Error saving remote file" — file write failed: causes and fixes across languages and libraries — this error's family across 38 libraries.

Related errors

• Cannot suffix an empty path
• Cannot read from an empty path
• Can't open %r for reading: %s
• %s function resource has no function name
• Root-level resource can't have a parent

AI-assisted analysis of apache/cassandra@88fd0f6a0e (2026-09-10). Data as JSON: /api/errors/d0ff10a1cfd80c58. Report an issue: GitHub.