GoogleContainerTools/jib · error · CacheCorruptedException

No or multiple layer files found for layer hash

Error message

No or multiple layer files found for layer hash <diffId> in directory: <layerDirectory>

What it means

retrieveTarLayer(diffId) mirrors retrieve() but looks up a layer by its diff ID for tar-based (e.g. jib:buildTar / Docker daemon) flows. It expects exactly one layer file in the diff ID directory; any other count raises CacheCorruptedException with the diffId hash and directory in the message.

Solutions

1. Clear the cache directory and rebuild the tar image
2. Ensure only one Jib build runs per cache directory at a time
3. Check the layer directory for stray files and remove them if you know the correct one
4. Upgrade Jib to the latest patch version

Example fix

// before
mvn jib:buildTar // fails: No or multiple layer files for sha256:diffid
// after
rm -rf ~/.cache/google-cloud-tools-java/jib && mvn jib:buildTar

long n = Files.list(diffIdDir).filter(Files::isRegularFile).count();
if (n != 1) deleteRecursively(diffIdDir);

try {
  jibBuildTar();
} catch (CacheCorruptedException e) {
  wipeCache();
  jibBuildTar();
}

When it happens

Trigger: retrieveTarLayer() is called and the layer directory keyed by diffId contains zero or multiple files recognized as layer files by CacheStorageFiles::isLayerFile.

Common situations: Interruption during tar layer extraction/writing, external tools modifying the cache, cache shared across Jib versions with different file naming so extra/missing files appear.

Related errors

• Expected valid layer digest as contents of selector file
• Layer file did not include valid hash
• Manifest cache empty
• Manifest list missing
• Manifest(s) missing

AI-assisted analysis of GoogleContainerTools/jib@fb949e2676 (2026-09-06). Data as JSON: /api/errors/1cc5539ea75c518a. Report an issue: GitHub.

Appendix: source

Thrown at jib-core/src/main/java/com/google/cloud/tools/jib/cache/CacheStorageReader.java:198

   * Retrieves the {@link CachedLayer} for the local base image layer with the given diff ID.
   *
   * @param diffId the diff ID
   * @return the {@link CachedLayer} referenced by the diff ID, if found
   * @throws CacheCorruptedException if the cache was found to be corrupted
   * @throws IOException if an I/O exception occurs
   */
  Optional<CachedLayer> retrieveTarLayer(DescriptorDigest diffId)
      throws IOException, CacheCorruptedException {
    Path layerDirectory = cacheStorageFiles.getLocalDirectory().resolve(diffId.getHash());
    if (!Files.exists(layerDirectory)) {
      return Optional.empty();
    }

    try (Stream<Path> files = Files.list(layerDirectory)) {
      List<Path> layerFiles =
          files.filter(CacheStorageFiles::isLayerFile).collect(Collectors.toList());
      if (layerFiles.size() != 1) {
        throw new CacheCorruptedException(
            cacheStorageFiles.getCacheDirectory(),
            "No or multiple layer files found for layer hash "
                + diffId.getHash()
                + " in directory: "
                + layerDirectory);
      }

      Path layerFile = layerFiles.get(0);
      return Optional.of(
          CachedLayer.builder()
              .setLayerDigest(cacheStorageFiles.getDigestFromFilename(layerFile))
              .setLayerSize(Files.size(layerFile))
              .setLayerBlob(Blobs.from(layerFile))
              .setLayerDiffId(diffId)
              .build());
    }
  }

View on GitHub (pinned to fb949e2676)