Vercel: build działa lokalnie, ale pada przez inną wersję Node.js
Poradnik techniczny · Kacper Bernecki
Projekt buduje się na komputerze, a na Vercel log pokazuje błąd składni albo niezgodność wersji runtime. Lokalny i produkcyjny Node mogą mieć inne możliwości języka, modułów i zależności binarnych.
Jak ustalić źródło błędu
Zapisz wersję node --version lokalnie oraz wersję Node wybraną w ustawieniach projektu Vercel.
Sprawdź pole engines w package.json i wymagania rzeczywistych zależności.
Co zrobić krok po kroku
1. Ustal wspieraną wersję Node dla frameworka i ujednolić ją w package.json, CI i projekcie Vercel.
2. Po aktualizacji wykonaj czystą instalację npm ci i nowy build, a nie samo ponowienie starego deploymentu.
Jak sprawdzić wynik
Identyczna wersja Node przechodzi wszystkie testy i build zarówno lokalnie, jak i w Vercel.
Czego nie robić
Nie wybieraj najnowszej wersji bez sprawdzenia zgodności natywnych pakietów.