vercel-common-errors

Umiejętność do debugowania wdrożeń na Vercel. Pomaga zidentyfikować i rozwiązać błędy na trzech poziomach: pipeline'u buildu, runtime'u funkcji serverless oraz sieci edge. Zawiera katalog najczęstszych problemów z kodami błędów, przyczynami i instrukcjami naprawy krok po kroku. Pracuje z Vercel CLI i API, analizuje logi deploymentu i funkcji.

1. Zainstaluj Vercel CLI na swoim komputerze, jeśli jeszcze go nie masz. Umiejętność wymaga dostępu do narzędzi takich jak vercel inspect, vercel logs oraz API Vercel.

2. Gdy napotkasz błąd Vercel, uruchom komendę vercel inspect <url-deploymentu>, aby sprawdzić status wdrożenia i szczegóły błędu. Jeśli chcesz śledzić logi funkcji w czasie rzeczywistym, użyj vercel logs <url-deploymentu> --follow.

3. Dla błędów buildu sprawdź plik vercel.json — upewnij się, że buildCommand pasuje do skryptu w package.json. Uruchom npm run build lokalnie, aby odtworzyć problem. Błędy tego typu pojawiają się podczas vercel deploy i widoczne są w logach buildu.

4. Dla błędów runtime'u (pojawiających się podczas wywoływania funkcji) przeanalizuj logi funkcji serverless. Umiejętność zawiera katalog typowych błędów z kodami (np. BUILD_FAILED, MISSING_BUILD_SCRIPT) i instrukcjami naprawy dla każdego z nich.

5. Jeśli potrzebujesz dostępu do szczegółowych informacji przez API Vercel, użyj tokenu dostępu: curl -s -H "Authorization: Bearer $VERCEL_TOKEN" https://api.vercel.com/v13/deployments/dpl_xxx | jq '.state, .errorMessage'. Zastąp dpl_xxx ID swojego deploymentu.

6. Wyzwól umiejętność frazami takimi jak "vercel error", "fix vercel", "vercel not working", "debug vercel", "vercel 500" lub "vercel build failed" — asystent automatycznie zastosuje odpowiedni katalog błędów i przeprowadzi Cię przez diagnostykę.