> For the complete documentation index, see [llms.txt](https://docs.emaillabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emaillabs.io/poradniki/techniczne-aspekty-e-maili-i-integracji/blad-dostarczania-wiadomosci-e-mail-najczestsze-kody-bledow.md).

# Błąd Dostarczania Wiadomości E-mail: Najczęstsze Kody Błędów

Serwery SMTP komunikują się między sobą w procesie wysyłania i odbierania e-maili. Jeśli na którymkolwiek etapie wystąpią problemy, serwer SMTP wysyła odpowiedź (często z kodem błędu), informując o przyczynie niedostarczenia wiadomości. Zrozumienie tych kodów pozwala na szybką diagnostykę i rozwiązanie problemów z dostarczalnością.

Kody SMTP są klasyfikowane według pierwszej cyfry:

* **2XX – Sukces:** Wiadomość została pomyślnie dostarczona.
* **3XX – Przekierowanie:** Wymagana dodatkowa akcja. Kody te są rzadko spotykane w praktyce, ponieważ nowoczesne systemy pocztowe zazwyczaj obsługują przekierowania automatycznie.
* **4XX – Błąd tymczasowy:** Serwer nadawczy podejmie kolejne próby dostarczenia wiadomości.
* **5XX – Błąd trwały:** Dostarczenie wiadomości nie powiodło się i wymagana jest interwencja.

{% hint style="warning" %}
Ważna uwaga: Poniższe tabele przedstawiają najczęstsze, typowe interpretacje kodów SMTP. Należy jednak pamiętać, że administratorzy serwerów mogą dostosowywać komunikaty zwrotne. Ostatecznym i najdokładniejszym źródłem informacji o przyczynie błędu jest zawsze pełna treść odpowiedzi zwróconej przez serwer, a nie tylko sam numer kodu.
{% endhint %}

### **Błędy tymczasowe (Soft Bounce) – Kody 4XX**

Są to tzw. "miękkie odbicia". Informują, że wiadomość nie została dostarczona za pierwszym razem, ale problem jest prawdopodobnie tymczasowy. Serwery wysyłające mogą być skonfigurowane do automatycznego podejmowania kolejnych prób dostarczenia wiadomości.

{% hint style="danger" %}
**Ważne:** Platforma EmailLabs nie ponawia automatycznie wysyłki wiadomości, które otrzymały status Softbounce z kodem błędu 4XX. Ponowną próbę dostarczenia należy zrealizować po stronie swojego systemu wysyłkowego.
{% endhint %}

<table><thead><tr><th width="109">Kod</th><th width="199">Znaczenie</th><th>Opis</th></tr></thead><tbody><tr><td>421</td><td>Usługa niedostępna</td><td>Serwer e-mail jest chwilowo przeciążony lub nieosiągalny (np. z powodu problemów z DNS).</td></tr><tr><td>422</td><td>Pełna skrzynka</td><td>Skrzynka odbiorcy nie może przyjąć więcej wiadomości.</td></tr><tr><td>450</td><td>Skrzynka niedostępna</td><td>Adres może być zablokowany, oznaczony jako spam lub tymczasowo nieaktywny.</td></tr><tr><td>451</td><td>Lokalny błąd serwera</td><td>Chwilowy problem po stronie serwera odbiorcy (np. przeciążenie, błąd konfiguracji).</td></tr><tr><td>452</td><td>Brak zasobów serwera</td><td>Serwer odbiorcy nie ma wystarczających zasobów systemowych (np. pamięci), aby przyjąć wiadomość.</td></tr></tbody></table>

***

### **Błędy trwałe (Hard Bounce) – Kody 5XX**

Są to tzw. "twarde odbicia". Oznaczają, że wiadomość trwale nie może zostać dostarczona. Otrzymanie kodu z tej serii wskazuje na problem, który wymaga interwencji ze strony nadawcy (np. usunięcia adresu z bazy).

<table><thead><tr><th width="112.75">Kod</th><th width="197">Znaczenie</th><th>Opis</th></tr></thead><tbody><tr><td>500</td><td>Błąd składni</td><td>Serwer nie zrozumiał komendy – możliwy problem z niepoprawnym formatowaniem wiadomości.</td></tr><tr><td>501</td><td>Nieprawidłowe parametry</td><td>Zazwyczaj wynika z błędnego adresu e-mail lub nieprawidłowych nagłówków.</td></tr><tr><td>503</td><td>Zła sekwencja komend</td><td>Komendy SMTP zostały wysłane w nieprawidłowej kolejności.</td></tr><tr><td>550</td><td>Skrzynka niedostępna</td><td>Najczęstszy kod błędu trwałego. Zazwyczaj oznacza, że adres e-mail nie istnieje. Może również sygnalizować, że wiadomość została odrzucona przez filtry antyspamowe.</td></tr><tr><td>551</td><td>Użytkownik nieobsługiwany</td><td>Skrzynka nie znajduje się na tym serwerze. Często wskazuje na problem z przekierowaniem poczty.</td></tr><tr><td>552</td><td>Przekroczony limit</td><td>Skrzynka odbiorcy przekroczyła dostępne miejsce. Uwaga: Ten sam problem bywa sygnalizowany kodem tymczasowym 422.</td></tr><tr><td>553</td><td>Nieprawidłowy adres</td><td>Błędny składniowo lub nieistniejący adres e-mail.</td></tr><tr><td>554</td><td>Odrzucenie transakcji</td><td>Ogólny błąd odrzucenia. Przyczyną może być zła reputacja domeny/IP, umieszczenie na czarnej liście lub brak uwierzytelnienia.</td></tr></tbody></table>

### **Jak zapobiegać błędom dostarczania wiadomości**

Skuteczne dostarczanie wiadomości to efekt właściwej konfiguracji, higieny list i dbałości o treść. Kluczowe kroki prewencyjne to:

1. **Wdrażaj i dbaj o aktualność uwierzytelnienia nadawcy** \
   Prawidłowa konfiguracja rekordów SPF, DKIM i DMARC jest absolutną podstawą.&#x20;
2. **Optymalizuj treść e-maili Unikaj słów i fraz, które mogą aktywować filtry antyspamowe.** \
   Używaj poprawnego kodu HTML i dbaj o odpowiednią proporcję tekstu do obrazów. \
   Więcej: [Jak Tworzyć E-maile w Formacie HTML](/poradniki/wyglad-i-zawartosc-e-maili/jak-tworzyc-e-maile-w-formacie-html.md)
3. **Zarządzaj listami odbiorców Stosuj mechanizm double opt-in przy zapisach.** \
   Regularnie czyść listy z nieaktywnych i niepoprawnych adresów, korzystając z zewnętrznych narzędzi do weryfikacji.
4. **Monitoruj reputację nadawcy Korzystaj z Google Postmaster Tools do analizy reputacji domeny.**\
   Regularnie sprawdzaj, czy Twoje IP lub domena nie znajdują się na publicznych czarnych listach (RBL).
5. **Zabezpiecz swoje środowisko wysyłkowe** \
   Używaj szyfrowania TLS dla połączeń SMTP. Zabezpiecz konta silnymi hasłami i uwierzytelnianiem dwuskładnikowym (2FA). Regularnie kontroluj konfigurację DNS.

   Więcej: [Bezpieczeństwo Konta Użytkownika](/centrum-bezpieczenstwa/bezpieczenstwo-konta-uzytkownika.md)