Kategoria: Vercel i hosting

Zmienna środowiskowa działa lokalnie, a na Vercel nie

Poradnik techniczny · Kacper Bernecki

Lokalny plik env nie jest automatycznie konfiguracją produkcji. Vercel rozdziela środowiska, a część zmiennych Next.js trafia do kodu już podczas budowania.

Krok po kroku

1. Sprawdź nazwę zmiennej w kodzie oraz środowisko wadliwego wdrożenia: Production lub Preview. Otwórz ustawienia projektu i porównaj przypisanie zmiennej, bez kopiowania sekretu do zgłoszenia.

2. Ustal, czy wartość ma być odczytywana na serwerze, czy w przeglądarce. Prefiks NEXT_PUBLIC_ oznacza wartość publiczną dołączaną do kodu klienta; nie używaj go dla kluczy API z uprawnieniami serwera.

3. Po zmianie konfiguracji utwórz nowe wdrożenie z właściwego commita. Stary build może nadal zawierać poprzednią publiczną wartość.

4. Jeśli pojawia się błąd, loguj informację o obecności konfiguracji, a nie jej treść. Sprawdź też spacje i znaki nowej linii, jeśli dostawca odrzuca poprawnie nazwaną zmienną.

5. Porównaj własną domenę z adresem wdrożenia. Upewnij się, że testujesz projekt i środowisko, w którym właśnie zmieniono ustawienia.

Jak sprawdzić, czy poprawka działa

Nowe wdrożenie powinno wykonać testową operację bez ujawniania sekretu w kodzie strony. Jeżeli klucz trafił wcześniej do klienta, usuń go z kodu i unieważnij u dostawcy.