[backport] feat(next/image): add lru disk cache and images.maximumDiskCacheSize#91660
Merged
Conversation
#89963) This PR adds an LRU disk cache so that reads and writes from the Image Optimization API will evict old entries based on the value of `images.maximumDiskCacheSize` configuration. The LRU ensures that cache reads bump the entry to the top so that they don't get evicted - only the least recently used entries get evicted. When `next start` is run, if there is an existing disk cache the we will replay the files in order to populate the LRU and respect `images.maximumDiskCacheSize` if it was changed. If no configuration is provided, default to 50% available disk space.
nextjs-bot
added
created-by: Next.js team
ztanner
changed the title
images.maximumDiskCacheSizeimages.maximumDiskCacheSize
Contributor
Failing test suitesCommit: 6abb589 | About building and testing Next.js
Expand output● create-next-app --app (App Router) › should create TailwindCSS project with --tailwind flag ● create-next-app --app (App Router) › should create an empty TailwindCSS project with --empty flag
Expand output● Next Lint › First Time Setup › installs eslint and eslint-config-next as devDependencies if missing with yarn ● Next Lint › First Time Setup › creates .eslintrc.json file with a default configuration ● Next Lint › First Time Setup › creates .eslintrc.json file with a default app router configuration ● Next Lint › First Time Setup › shows a successful message when completed
Expand output● create-next-app --no-app (Pages Router) › should create TailwindCSS project with --tailwind flag ● create-next-app --no-app (Pages Router) › should create an empty TailwindCSS project with --empty flag
Expand output● CNA options matrix - app › --app --no-turbopack --js --import-alias=@acme/* --eslint --src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --js --import-alias=@acme/* --eslint --no-src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --js --import-alias=@/* --eslint --src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --js --import-alias=@/* --eslint --no-src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --js --no-import-alias --eslint --src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --js --no-import-alias --eslint --no-src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --ts --import-alias=@acme/* --eslint --src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --ts --import-alias=@acme/* --eslint --no-src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --ts --import-alias=@/* --eslint --src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --ts --import-alias=@/* --eslint --no-src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --ts --no-import-alias --eslint --src-dir --tailwind ● CNA options matrix - app › --app --no-turbopack --ts --no-import-alias --eslint --no-src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --js --import-alias=@acme/* --eslint --src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --js --import-alias=@acme/* --eslint --no-src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --js --import-alias=@/* --eslint --src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --js --import-alias=@/* --eslint --no-src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --js --no-import-alias --eslint --src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --js --no-import-alias --eslint --no-src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --ts --import-alias=@acme/* --eslint --src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --ts --import-alias=@acme/* --eslint --no-src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --ts --import-alias=@/* --eslint --src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --ts --import-alias=@/* --eslint --no-src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --ts --no-import-alias --eslint --src-dir --tailwind ● CNA options matrix - pages › --no-app --no-turbopack --ts --no-import-alias --eslint --no-src-dir --tailwind |
styfle
reviewed
Mar 19, 2026
styfle
approved these changes
Mar 19, 2026
|
We had a an issue with the 15.5.14 release, because we had persisted the cache folder with a mount to the host system. This effectively disabled the file cache as new files were not created - supposably because the cache folder was already over the limit but didn't have the old files in the ledger so they could be deleted. Hope this helps anybody facing the same issue. I think maybe this could have been a minor upgrade instead of a patch |
|
Oh we fixed it by deleting the .next/cache/images folder and letting it get recreated |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Backports:
images.maximumDiskCacheSize#89963