CarGuo/GSYVideoPlayer · error · ProxyCacheException

Error renaming file %s to %s for completion!

Error message

Error renaming file %s to %s for completion!

What it means

After a successful rename, FileCache.complete reopens the finished file read-only (new RandomAccessFile(file, "r')) and touches DiskUsage. IOException here becomes ProxyCacheException('Error opening <file> as disc cache'). The file exists and is renamed, but can no longer be opened for reading - permissions changed, file deleted instantly by a cleaner, or fs errors.

Source

Thrown at gsyVideoPlayer-proxy_cache/src/main/java/com/danikula/videocache/file/FileCache.java:98

            dataFile.close();
            diskUsage.touch(file);
        } catch (IOException e) {
            throw new ProxyCacheException("Error closing file " + file, e);
        }
    }

    @Override
    public synchronized void complete() throws ProxyCacheException {
        if (isCompleted()) {
            return;
        }

        close();
        String fileName = file.getName().substring(0, file.getName().length() - TEMP_POSTFIX.length());
        File completedFile = new File(file.getParentFile(), fileName);
        boolean renamed = file.renameTo(completedFile);
        if (!renamed) {
            throw new ProxyCacheException("Error renaming file " + file + " to " + completedFile + " for completion!");
        }
        file = completedFile;
        try {
            dataFile = new RandomAccessFile(file, "r");
            diskUsage.touch(file);
        } catch (IOException e) {
            throw new ProxyCacheException("Error opening " + file + " as disc cache", e);
        }
    }

    @Override
    public synchronized boolean isCompleted() {
        return !isTempFile(file);
    }

    /**
     * Returns file to be used fo caching. It may as original file passed in constructor as some temp file for not completed cache.
     *

View on GitHub (pinned to e5d74d3aa9)

Solutions

1. Enforce one proxy instance per cache directory (singleton pattern)
2. On the error, purge the url's cache entry and let the next playback re-download
3. Use internal, app-private cache storage immune to external cleaners
4. If persistent, check device storage health / remount loops

Example fix

// before - fatal
catch (ProxyCacheException e) { throw e; }

// after - purge entry and degrade to no-cache playback
catch (ProxyCacheException e) {
    Log.w(TAG, "reopening completed cache failed, purging entry", e);
    new File(cacheDir, md5(url)).delete();
    playDirectWithoutCache(url);
}

File f = new File(cacheDir, md5(url));
if (!f.exists() || !f.canRead()) { /* purge entry, degrade to no-cache */ f.delete(); }

catch (ProxyCacheException e) {
    if (String.valueOf(e.getMessage()).contains("Error opening") && e.getMessage().contains("as disc cache")) {
        purgeEntry(url); playDirect(url);
    } else throw e;
}

When it happens

Trigger: Immediately after rename, something deletes or locks the completed file (eviction thread from another proxy instance, cleaner app), or the directory's permissions prevent reopen. Rare; requires a race or external interference in the microseconds between rename and reopen.

Common situations: Two cache instances trimming the same folder concurrently; storage cleaner racing the proxy; almost never seen in single-instance, internal-storage setups.

Related errors

• Error reading source ${errorsCount} times
• Error using file ${file} as disc cache
• Error reading %d bytes with offset %d from file[%d bytes] to
• Error append cache: cache file %s is completed!
• Error writing %d bytes to %s from buffer with size %d

AI-assisted analysis of CarGuo/GSYVideoPlayer@e5d74d3aa9 (2026-08-14). Data as JSON: /api/errors/78a8581ac32dc557. Report an issue: GitHub.