Caching fallback if there is no exact hit

[dbartholomae]

Hi there,

at the moment, caching only hits if the exact same lockfile exists, but most of the time, even it the lockfile slightly changes, it is still beneficial to restore cache instead of downloading everything from scratch (most likely only ~1 dependency changed).
I would propose that, by default, cache falls back to node-cache-${platform}-${packageManager} instead of only checking node-cache-${platform}-${packageManager}-${fileHash}.
If this is of interest, I'm happy to provide a PR. It seems to only need a test and a one line change in https://github.com/actions/setup-node/blob/main/src/cache-restore.ts#L44

See also #304 (comment)

[oxc]

There seem to be implementations for this in #323 and thrivehealth@bd6483a

[belgattitude]

Just for sharing some workarounds with @action/cache

• With Pnpm 7+: https://gist.github.com/belgattitude/838b2eba30c324f1f0033a797bab2e31
• With Yarn 3+: https://gist.github.com/belgattitude/042f9caf10d029badbde6cf9d43e400a

[voxpelli]

New PR to fix this: #702

[voxpelli]

Rebased and updated the PR over at #702, needed adaption after #744 was merged

[aparnajyothi-y]

Hello Everyone, Thank you for raising this request and for the thoughtful PR. We completely understand the motivation behind introducing a fallback caching mechanism, as it could help improve efficiency in certain scenarios.

That said, after discussion, we’ve decided not to move forward with this change. The main concern is that fallback caching may lead to unpredictable behavior like restoring stale dependencies, introducing subtle inconsistencies, and making workflows harder to debug. Ensuring reproducibility and determinism is a core design principle for setup-node, and strict cache key matching helps guarantee that.

For teams that prefer more flexible caching strategies, we recommend using actions/cache directly, where you can design custom keys and fallbacks as needed.

We really appreciate your contribution and the effort put into this proposal. Even though we can’t merge this change, we encourage you to continue sharing ideas and feedback with us, as it helps shape the future improvements.