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.