Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

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 web

2. 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_BAZY

3. 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.