Kategoria: Next.js, React i TypeScript

TypeScript TS2307 Cannot find module mimo udanej instalacji npm

Poradnik techniczny · Kacper Bernecki

Edytor lub build zgłasza TS2307 dla biblioteki, która figuruje w node_modules. Przyczyną może być niewłaściwe moduleResolution, brak deklaracji typów lub różnica nazwy importu.

Jak rozpoznać źródło problemu

Sprawdź package.json i wersję paczki oraz to, czy moduł ma types w exports lub pliku deklaracji. Porównaj tsconfig moduleResolution z rzeczywistym runtime ESM/CJS i frameworkiem.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Dopasuj ścieżkę importu oraz konfigurację moduleResolution do bundlera lub NodeNext zgodnie z pakietem. Jeśli biblioteka nie dostarcza typów, doinstaluj właściwy pakiet @types lub własną minimalną deklarację zamiast udawać typ any.

Jak przetestować rozwiązanie

Czysty typecheck na CI odnajduje moduł, a runtime uruchamia ten sam import bez błędu.

Bezpieczeństwo i ograniczenia

Nie zmieniaj losowo opcji tsconfig, jeśli problem jest w eksporcie konkretnej paczki.