Kategoria: Vercel i hosting

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.