Kategoria: Next.js, React i TypeScript

TypeScript: alias paths działa w edytorze, ale Node nie znajduje modułu

Poradnik techniczny · Kacper Bernecki

TS i IDE rozwiązują @/lib/config, lecz uruchomiony skrypt Node zgłasza MODULE_NOT_FOUND. paths w tsconfig służą do rozwiązywania typów i nie gwarantują zamiany importów w wygenerowanym kodzie Node.

Jak ustalić źródło błędu

Sprawdź rozbieżność między ts-node, bundlerem, tsc i node uruchamiając dokładnie komendę produkcyjną.

Podejrzyj wygenerowane pliki JS, aby zobaczyć, czy alias pozostał w specyfikatorze importu.

Co zrobić krok po kroku

1. Skonfiguruj zgodne aliasy w narzędziu runtime/bundlera lub użyj bezpośrednich importów względnych.

2. Dla kodu ESM rozważ poprawne package imports i spójną konfigurację eksportów pakietu.

Jak sprawdzić wynik

Skrypt po zbudowaniu uruchamia się bez dodatkowych hacków, a moduł jest rozwiązywany tak samo na CI i lokalnie.

Czego nie robić

Nie zakładaj, że samo baseUrl/paths w tsconfig zmienia działanie importów w czystym Node.js.