Sentry Answers>Node.js>

How do I resolve a "Cannot find module" error using Node.js?

How do I resolve a "Cannot find module" error using Node.js?

Matthew C.

The ProblemJump To Solution

You have a JavaScript dependency in your Node.js project. When you try to import an item from the dependency module, you get the following Node.js error:

Click to Copy
Error: Cannot find module '<module name>'

This error occurs when Node.js can’t find a module that you imported into your code. The name of the missing module is provided in the error message. How do you fix this error?

The Solution

This error is caused by a missing dependency, an incorrect file path, an outdated dependency, or corrupt files. The commands shown in the solution are for the npm package manager. There are equivalent commands for Yarn and pnpm.

Make sure the dependency is installed in the correct place

When a project’s Node.js dependencies are installed, they are added to the node_modules folder in the root directory of the project. Check the package.json file to see if the missing module is in the project’s dependencies or devDependencies. If it is not, install the dependency:

Click to Copy
npm install <dependency name>

If the dependency is in the package.json file, make sure that the node_modules folder is in the root folder of the project and that the missing module is in the node_modules folder. Also, make sure that the file path in the module import is correct.

Update the dependency

The issue may be caused by importing from an outdated module. To fix this, update the dependency to the latest version:

Click to Copy
npm update [<pkg>...]

Delete and reinstall the dependencies

If all else fails, you can try the following:

  1. Delete the node_modules folder:
Click to Copy
rm -rf node_modules
  1. Delete the package-lock.json file:
Click to Copy
rm -f package-lock.json
  1. Clear the Node.js cache, which may be corrupted:
Click to Copy
npm cache clean --force
  1. Reinstall the dependencies:
Click to Copy
npm install

If you still have an error, you can try to reinstall Node.js and npm to make sure that you have the latest versions and that any corrupted files are replaced.

  • Community SeriesIdentify, Trace, and Fix Endpoint Regression Issues
  • ResourcesBackend Error Monitoring 101
  • Syntax.fm logo
    Listen to the Syntax Podcast

    Tasty treats for web developers brought to you by Sentry. Get tips and tricks from Wes Bos and Scott Tolinski.

    SEE EPISODES

Loved by over 4 million developers and more than 90,000 organizations worldwide, Sentry provides code-level observability to many of the world’s best-known companies like Disney, Peloton, Cloudflare, Eventbrite, Slack, Supercell, and Rockstar Games. Each month we process billions of exceptions from the most popular products on the internet.

© 2024 • Sentry is a registered Trademark
of Functional Software, Inc.