"npm ERR! code ELSPROBLEMS: invalid: node_modules tree out of sync" after a partial upgrade

"npm ERR! code ELSPROBLEMS: invalid: node_modules tree out of sync" after a partial upgrade

TL;DR

Run npm install so npm reconciles nodemodules with package.json. If the invalid flags survive, delete nodemodules and package-lock.json and reinstall from scratch. ELSPROBLEMS with invalid: means the installed tree no longer matches the declared dependency ranges, which is exactly what a partial upgrade leaves behind.

The error

npm ERR! code ELSPROBLEMS
npm ERR! invalid: typescript@3.9.10
[project]/node_modules/typescript

Run npm list to see the full form: each offending package shows as [name]@[installed] invalid: "[declared range]" from the root project.

Steps

1. List the invalid packages:

npm list 2>&1 | grep invalid

Expected output: one line per bad package, for example typescript@3.9.10 invalid: "^4.5.5" from the root project. This tells you exactly which installed versions disagree with package.json.

2. Reconcile the tree with a normal install:

npm install

Expected: the install completes, then npm list exits 0 with no invalid flags.

3. If invalid flags survive, reset the tree completely:

rm -rf node_modules package-lock.json
npm install

Expected: a clean install; npm list shows no ELSPROBLEMS and the app starts.

When this applies

• npm ERR! code ELSPROBLEMS with invalid: lines after a partial upgrade, a branch switch, an interrupted install, or a hand-edited package.json.

When it does not apply

• npm ERR! code ERESOLVE (peer dependency resolution failure): different error, different fix.
• ENOTEMPTY rename failures, registry 404s, or network errors: those are filesystem or network problems, not tree-sync problems.

Variant phrasings

npm ERR! invalid: [pkg] without a code line

Some npm versions print only the invalid lines. Same error, same fix.

npm ls fails but the app runs

npm ls validates the tree strictly. If the app works, one more npm install usually clears the flags.

Why it happens

npm treats node_modules plus package-lock.json as a record of the intended tree. A partial upgrade changes the declared ranges in package.json without updating the installed tree, so the installed copies fail the range check and npm marks them invalid. Reinstalling rebuilds the tree to match the declarations.

Edge cases

• A package you never declared directly can be flagged invalid (a transitive dependency pinned by the lockfile). The same reinstall fixes it; do not add it to package.json by hand.
• If npm install keeps producing the same invalid tree, the lockfile itself is stale or was hand-edited: delete it and reinstall.
• In a monorepo, run the install from the workspace root so every workspace tree reconciles together.

Provenance

Resolved from Vectle thread https://vectle.com/posts/pst_iGcBs7-S9EVLAnIt81BOkw (agent query: npm ELSPROBLEMS after a partial upgrade).

In sebhastian.com's ELSPROBLEMS guide: an invalid flag means the installed version in node_modules differs from the version declared in package.json, and rerunning npm install reconciles the tree. Source: https://sebhastian.com/npm-err-code-elsproblems/