Cache miss when restoring within a reusable workflow

Greetings!

Our organization uses a reusable workflow to build our docker images. We recently attempted to add caching to this workflow to speed up the build process. While we already use the cache action for our separate CI workflow, we've noticed the build workflow always fails to hit the cache and it's unclear why.

Here's the current reusable build workflow

build.yml

We verified multiple times that Cache exists in the default branch (main)

Based on the documentation we should be able to restore this cache in our feature branches, but we're getting cache misses on the restore steps

Is there documentation related to this particular scenario or are we missing a key step to make this work? Any help would be appreciated.

Start by reading the linked build.yml reusable workflow and the cache action documentation for cache restoration in feature branches. Compare the workflow's restore steps with the reported cache-existence and cache-miss screenshots. Done means the cause is documented or the workflow reliably restores the expected cache.