Docker
Docker: aplikacja nie łączy się z bazą
Rozdziel błędy DNS, portu, gotowości bazy i uwierzytelnienia. localhost w kontenerze to zwykle niewłaściwy adres bazy.
Środowisko i zakresCompose, aplikacja web i usługa bazy db. Przykład portu PostgreSQL: 5432; dla MySQL/MariaDB zwykle 3306.
Co może być przyczyną?
- Aplikacja wskazuje localhost zamiast nazwy usługi db.
- Kontenery nie należą do wspólnej sieci.
- Baza jeszcze się inicjalizuje albo dane logowania nie pasują do istniejącego wolumenu.
1. Sprawdź status i komunikat
Connection refused wskazuje inny etap niż authentication failed. Nie zmieniaj hasła tylko dlatego, że połączenie TCP jest odrzucane.
docker compose ps -a
docker compose logs --tail 80 db
docker compose logs --tail 80 web2. Porównaj sieci i adres
Odczyt pokazuje tylko sieci, bez zmiennych z hasłami. Kontenery powinny mieć co najmniej jedną wspólną sieć. Na tej sieci użyj db i portu kontenera, nie portu opublikowanego na hoście.
docker inspect --format '{{json .NetworkSettings.Networks}}' NAZWA_KONTENERA_APLIKACJI
docker inspect --format '{{json .NetworkSettings.Networks}}' NAZWA_KONTENERA_BAZY3. Odróżnij uruchomienie od gotowości
depends_on bez warunku zdrowia nie gwarantuje gotowości bazy do zapytań. Sprawdź log zakończonej inicjalizacji oraz healthcheck, jeśli został skonfigurowany.
Jak naprawić problem?
- Popraw host bazy na nazwę usługi i port na wewnętrzny port bazy.
- Dodaj obie usługi do wspólnej sieci projektu.
- Dla startu aplikacji użyj healthcheck bazy i depends_on z condition: service_healthy oraz ponawiania połączeń po stronie aplikacji.
- Jeśli błąd dotyczy hasła, porównaj konto z rzeczywistą bazą. Zmiana zmiennej inicjalizacyjnej obrazu nie musi zmieniać hasła w istniejącej bazie.
Jak potwierdzić naprawę?
Wykonaj przez aplikację odczyt wymagający bazy. Sprawdź logi aplikacji po odtworzeniu jej kontenera oraz po kontrolowanym uruchomieniu całego projektu w środowisku testowym.
Czego nie robić?
Nie publikuj portu bazy do internetu jako sposobu na naprawę sieci kontenerów. Nie usuwaj wolumenu, żeby „zresetować hasło”.
Źródła i dokumentacja
Data publikacji: 24.09.2026.