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.