Resolving "Cache key files could not be found" error on Bitbucket pipelines

Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.

Summary

Users might observe "Cache key files could not be found" error during build set up step on pipelines which results in failure of the build

Key file does not exist – Cache key files could not be found. Key file is outside the repository – Cache key files could not be found.

Cause

  • Providing incorrect path to the file in YAML config

  • Error in the file name defined

  • Presence of lock files

Solution

Updated on September 25, 2025

Still need help?

The Atlassian Community is here for you.