Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/utils' is not supported resolving ES modules imported from /app/index.js
În modulele ES nu poți importa un dosar (import ... from "./utils") și nici să lași Node să ghicească index.js. Scrie calea completă către fișier, cu extensie: import ... from "./utils/index.js".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În CommonJS, require("./utils") caută automat utils.js, utils/index.js sau main din utils/package.json. Modulele ES nu mai fac asta: specificatorul e tratat ca o adresă exactă, iar ./utils indică un dosar, nu un fișier. Node refuză și îți spune ce a încercat să încarce (Directory import '/app/utils') și din ce fișier (imported from /app/index.js).
Node 22+ adaugă de obicei și o sugestie: Did you mean to import "./utils/index.js"?. De cele mai multe ori e exact reparația.
Eroarea apare des când treci un proiect de pe CommonJS pe "type": "module", când copiezi importuri dintr-un proiect cu bundler (Vite, webpack și TypeScript pot rezolva dosare, Node nu), sau la importul unui subdosar al unui pachet care nu are "exports", de exemplu pachet/locale.
De ce apare: cauzele frecvente
1Import de dosar în loc de fișier
import { formatLei } from "./utils";import { formatLei } from "./utils/index.js";Modulele ES cer calea exactă, cu numele fișierului și extensia.
2Cod scris pentru un bundler, rulat direct cu Node
// merge în Vite, pică în Node
import { api } from "./servicii";import { api } from "./servicii/index.js";Bundler-ele au reguli proprii de rezolvare. Codul rulat direct cu Node trebuie să respecte regulile lui.
3Subdosar al unui pachet fără exports
import ro from "pachet/locale/ro";import ro from "pachet/locale/ro/index.js";Dacă pachetul nu declară căile în "exports", Node nu completează index.js pentru tine; scrie calea completă sau caută în documentație importul recomandat.
Repară eroarea, direct în pagină
Proiectul folosește module ES ("type": "module"), iar index.js dă Error [ERR_UNSUPPORTED_DIR_IMPORT], pentru că importă dosarul ./utils. Corectează importul, ca programul să afișeze numele produselor cu majuscule și prețurile formatate.
import { formatLei, majuscule } from "./utils";
const produse = [
{ nume: "cafea boabe", pret: 42 },
{ nume: "ceai verde", pret: 18.5 },
];
for (const p of produse) {
console.log(`${majuscule(p.nume)}: ${formatLei(p.pret)}`);
}CAFEA BOABE: 42.00 lei CEAI VERDE: 18.50 lei
Indiciu
Funcțiile sunt în fișierul utils/index.js; scrie calea completă, cu extensia.
Reparația
import { formatLei, majuscule } from "./utils/index.js";
const produse = [
{ nume: "cafea boabe", pret: 42 },
{ nume: "ceai verde", pret: 18.5 },
];
for (const p of produse) {
console.log(`${majuscule(p.nume)}: ${formatLei(p.pret)}`);
}De ce merge
În modulele ES, specificatorul din import e o adresă exactă, iar Node nu mai caută index.js într-un dosar, cum făcea require. ./utils/index.js indică direct fișierul cu funcțiile, așa că importul se rezolvă fără ghicit. Aceeași regulă cere și extensia: ./utils/index fără .js ar da ERR_MODULE_NOT_FOUND.
Alte forme ale mesajului
Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/utils' is not supported resolving ES modules imported from /app/index.js Did you mean to import "./utils/index.js"?Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/node_modules/pachet/locale' is not supported resolving ES modules imported from /app/index.jsError [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/src/routes' is not supported resolving ES modules imported from /app/src/server.js
Cum o eviți pe viitor
- În modulele ES scrie întotdeauna calea completă:
./utils/index.js, nu./utilssau./utils/index. - Pentru importuri scurte, definește aliasuri în
package.jsoncu"imports", de exemplu"#utils": "./utils/index.js". - În TypeScript cu
"module": "nodenext", compilatorul te obligă să scrii extensiile, deci prinzi problema înainte de rulare.
Întrebări frecvente
De ce require("./utils") mergea?
Algoritmul CommonJS încearcă mai multe variante: fișier cu .js, .json, dosar cu index.js. Modulele ES folosesc rezolvarea de tip URL, fără ghicit, ca să fie la fel ca în browser.
Există o opțiune care să reactiveze comportamentul vechi?
A existat --experimental-specifier-resolution=node, dar a fost eliminată în Node 19. Calea corectă e să scrii importurile complete.
Erori înrudite
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/app/utils/preturi.js' imported from /app/index.js Un import dintr-un modul ES arată spre un fișier care nu există: calea e greșită sau lipsește extensia. În modulele ES extensia este obligatorie: import x from "./preturi.js", nu "./preturi". Verifică dosarul și numele fișierului. SyntaxError: Cannot use import statement outside a module Node încarcă fișierul ca modul CommonJS, unde import nu e permis. Ori treci pe require, ori spui că fișierul e modul ES: extensia .mjs sau "type": "module" în package.json. Fișierele .cjs și proiectele cu "type": "commonjs" acceptă doar require. Error: Cannot find module './calcul' Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule"). Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
