How to fix npm ERR! code EBADSHRINKWRAP npm ERR! Invalid shrinkwrap file in npm

npmBEGINNERMEDIUM

The EBADSHRINKWRAP error occurs when npm detects structural or data inconsistencies in the npm-shrinkwrap.json file, typically from corruption, platform-specific dependencies, or conflicting versions.

What this error means

The EBADSHRINKWRAP error occurs when npm detects structural or data inconsistencies in the npm-shrinkwrap.json file (or package-lock.json). This typically happens when the lock file doesn't match the actual packages installed in node_modules, or when the lock file itself becomes corrupted. The shrinkwrap file serves as a precise record of which package versions should be installed, so when npm detects discrepancies, it halts the installation process to prevent unpredictable behavior. This is a safety mechanism, though the error message doesn't always clearly indicate the root cause. This issue is common when working across different operating systems (macOS to Linux), different npm versions, or after interrupted installations.

How to fix "npm ERR! code EBADSHRINKWRAP npm ERR! Invalid shrinkwrap file"

1Delete and regenerate lock files

Remove the corrupted lock file and node_modules, then reinstall:

bash

# Remove node_modules and all lock files
rm -rf node_modules npm-shrinkwrap.json package-lock.json

# Perform a clean install
npm install

# Regenerate the shrinkwrap file
npm shrinkwrap

This forces npm to fetch fresh dependency metadata from the registry and creates a clean lock file.

2Run npm prune before regenerating

If you still have node_modules but the lock file is stale:

bash

# Remove extraneous packages
npm prune

# Regenerate the shrinkwrap file
npm shrinkwrap

npm prune removes packages from node_modules that aren't listed in package.json, eliminating "extraneous" packages that cause EBADSHRINKWRAP errors.

3Clear npm cache and reinstall

Cached package metadata can sometimes be stale or corrupt:

bash

# Clear the npm cache completely
npm cache clean --force

# Remove lock files and node_modules
rm -rf node_modules npm-shrinkwrap.json package-lock.json

# Reinstall everything
npm install

4Verify package.json and lock file are in sync

Ensure package.json and lock file match:

bash

# Ensure package.json and lock file match
npm install

# Check that installation succeeded completely
npm ls

# If no errors, regenerate the lock file
rm npm-shrinkwrap.json
npm shrinkwrap

Run npm ls to see the full dependency tree and identify any issues.

5For cross-platform teams, use package-lock.json instead

If your team works across different operating systems, avoid npm-shrinkwrap.json:

bash

# Remove npm-shrinkwrap.json (it takes precedence)
rm npm-shrinkwrap.json

# Let npm generate package-lock.json on install
npm install

# Commit package-lock.json instead
git add package-lock.json
git commit -m "Use package-lock.json for cross-platform compatibility"

package-lock.json handles cross-platform dependencies better than shrinkwrap.

6Ensure consistent npm and Node.js versions across the team

Version mismatches can cause lockfileVersion incompatibilities:

bash

# Add a .nvmrc file to specify Node.js version
echo "18.0.0" > .nvmrc

# Team members update to match
nvm install $(cat .nvmrc)
npm install --global npm@9

Create a .nvmrc file specifying your Node.js version and document the required npm version in your README.

How to fix npm ERR! code EBADSHRINKWRAP npm ERR! Invalid shrinkwrap file in npm

What this error means

Typical symptoms

Common causes

How to fix "npm ERR! code EBADSHRINKWRAP npm ERR! Invalid shrinkwrap file"

Advanced notes

Related errors

Official resources & further reading