¿Qué significa ERR_MODULE_NOT_FOUND?

ERR_MODULE_NOT_FOUND es lanzado por Node.js cuando no puede localizar un módulo especificado en una sentencia import o require(). Es el error de resolución de módulos de Node.js y cubre tanto paquetes npm faltantes como archivos locales ausentes.

Por qué ocurre

• •El paquete no está instalado (falta en node_modules), frecuentemente porque npm install no se ejecutó después de clonar el repositorio.
• •Una ruta de importación relativa apunta a un archivo que no existe o usa una ruta incorrecta.
• •En modo ESM, se omite la extensión del archivo en una importación relativa (Node.js ESM requiere extensiones explícitas).
• •El nombre de un paquete fue renombrado o el punto de entrada cambió en una actualización de versión mayor.

Ejemplos

// package.json has "type": "module"
import { helper } from "./utils/helper.js";

helper();

Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/project/utils/helper.js'
imported from /project/index.js

// Ensure the file exists at the exact path, including extension
// For ESM imports, the .js extension is required even for TypeScript source
import { helper } from "./utils/helper.js";

helper();

// If using CommonJS:
// const { helper } = require("./utils/helper");

Errores relacionados

• ModuleNotFoundError
• ImportError