Fehlerbehebung
SMTP-Fehlerbehebung
Alle Antwortcodes, die das SMTP-Relay von Emailit zurückgeben kann, mit Ursache und Lösung, dazu blockierte Ports, TLS-Fehler, Timeouts und angenommene E-Mails, die nicht zugestellt werden.
Nutzen Sie diese Seite, wenn das SMTP-Relay eine Nachricht ablehnt oder Ihr Client keine Verbindung herstellen kann. Die Fehler sind nach der Phase der SMTP-Kommunikation gruppiert, in der sie auftreten, und zu jedem sind Ursache und Lösung angegeben.
Antwortcode finden
- In Ihrer Anwendung. Mail-Bibliotheken nehmen die Antwort des Servers in den Fehler auf, zum Beispiel
Error: Invalid login: 535 Authentication failedin Nodemailer oderSMTPAuthenticationError: (535, b'Authentication failed')in Python. - In Emailit. Email APILogs erfasst jede eingereichte Nachricht mit der Quelle SMTP und ihrem Antwortcode sowie Ablehnungen wegen Rate Limits und fehlgeschlagene Anmeldungen für Schlüssel, die Emailit zuordnen kann. Filtern Sie nach Status code oder API key.
- Mit einem manuellen Test. Führen Sie den cURL-Befehl aus Testnachricht senden mit
-vaus, um die gesamte Kommunikation zu sehen.
Codes, die mit 4 beginnen, sind vorübergehend: Ordentlich programmierte Clients versuchen es später erneut. Codes, die mit 5 beginnen, sind dauerhaft: Beheben Sie die Ursache, bevor Sie erneut senden.
Kurzreferenz
| Code und Meldung | Phase | Abschnitt |
|---|---|---|
535 Authentication failed |
AUTH | Anmeldefehler |
454 Temporary authentication failure |
AUTH | Anmeldefehler |
452 4.4.5 Messages per second limit exceeded |
MAIL FROM | Fehler durch Rate Limits |
452 4.5.3 Daily message limit exceeded |
MAIL FROM | Fehler durch Rate Limits |
451 Temporary local error in processing |
Beliebig | Vorübergehende Fehler |
501 Invalid RCPT TO |
RCPT TO | Empfängerfehler |
530 Authentication required |
RCPT TO | Empfängerfehler |
535 Mail server has been suspended |
RCPT TO | Empfängerfehler |
550 Unverified workspaces can only send to… |
RCPT TO | Empfängerfehler |
552 Message too large |
DATA | Nachrichtenfehler |
530 From/Sender domain is not verified for this workspace |
DATA | Nachrichtenfehler |
530 API key is restricted to sending domain |
DATA | Nachrichtenfehler |
550 Sending from this domain is paused |
DATA | Nachrichtenfehler |
550 Loop detected |
DATA | Nachrichtenfehler |
550 Message processing failed |
DATA | Nachrichtenfehler |
452 Insufficient credits to receive inbound email |
DATA | Fehler bei eingehenden E-Mails |
Anmeldefehler
Diese Fehler treten auf, wenn Ihr Client AUTH sendet.
535 Authentication failed
Ursache. Das Passwort ist kein gültiger API-Schlüssel eines Workspaces. Der Schlüssel enthält möglicherweise einen Tippfehler oder zusätzliche Leerzeichen, wurde gelöscht oder neu generiert oder ist ein alter, ersetzter Schlüssel.
Lösung. Kopieren Sie den Schlüssel erneut von dort, wo Sie ihn beim Erstellen gespeichert haben. Emailit zeigt Schlüssel nur einmal an. Wenn Sie ihn nicht mehr haben, erstellen Sie einen neuen Schlüssel unter Email APIAPI Keys. Verwenden Sie emailit als Benutzernamen und den vollständigen Schlüssel, beginnend mit secret_, als Passwort. Siehe Warum gibt SMTP 535 Authentication failed zurück?.
454 Temporary authentication failure
Ursache. Emailit konnte den Schlüssel wegen eines internen Fehlers nicht prüfen.
Lösung. Versuchen Sie es nach einer kurzen Wartezeit erneut. Hält der Fehler länger als ein paar Minuten an, prüfen Sie status.emailit.com und kontaktieren Sie den Support.
Fehler durch Rate Limits
Diese Fehler treten auf, wenn Ihr Client MAIL FROM sendet, um eine Nachricht zu beginnen.
452 4.4.5 Messages per second limit exceeded
Ursache. Ihr Workspace hat in der letzten Sekunde mehr Nachrichten gesendet, als sein Limit pro Sekunde erlaubt, standardmäßig 2. Das Limit wird mit der API geteilt und zählt jede SMTP-Transaktion als eine Nachricht. Die Zahlen in Klammern zeigen den aktuellen Zählerstand und das Limit.
Lösung. Die meisten Clients wiederholen 452 automatisch. Um den Fehler zu vermeiden, senden Sie über eine Warteschlange mit begrenzter Parallelität oder verwenden Sie eine einzige Verbindung und senden Nachrichten nacheinander. Wenn Sie eine höhere Rate brauchen, nutzen Sie Request Increase auf der Karte Sending Limits der Startseite der Weboberfläche. Siehe Limits.
452 4.5.3 Daily message limit exceeded
Ursache. Der Workspace hat sein Tageslimit erreicht, standardmäßig 5.000 Nachrichten, gemeinsam mit der API.
Lösung. Der Versand wird nach Mitternacht UTC fortgesetzt. Beantragen Sie über die Karte Sending Limits auf der Startseite der Weboberfläche ein höheres Tageslimit. Workspaces mit Pro oder Business erhalten außerdem automatische Erhöhungen, wenn ihre Versandgesundheit gut ist.
Vorübergehende Fehler
451 Temporary local error in processing
Ursache. Bei der Verarbeitung des Befehls ist in Emailit ein interner Fehler aufgetreten. Das kann in jeder Phase passieren.
Lösung. Versuchen Sie es später erneut. Mailserver und die meisten Bibliotheken tun das bei 4xx-Antworten automatisch. Hält der Fehler an, kontaktieren Sie den Support und nennen Sie den Zeitpunkt des Versuchs.
Empfängerfehler
Diese Fehler treten auf, wenn Ihr Client für jeden Empfänger RCPT TO sendet.
501 Invalid RCPT TO
Ursache. Die Empfängeradresse ist fehlerhaft, zum Beispiel fehlt das @ oder davor oder danach steht nichts. Die vollständige Meldung lautet Invalid RCPT TO format oder Invalid RCPT TO.
Lösung. Validieren Sie Adressen vor dem Senden. Prüfen Sie auf leere Werte und auf Anzeigenamen, die dort übergeben werden, wo nur eine Adresse erwartet wird.
530 Authentication required
Ursache. Der Client hat sich nicht angemeldet, oder seine Anmeldung ist fehlgeschlagen und er hat trotzdem weitergemacht. Ohne Anmeldung nimmt das Relay nur E-Mails für die eigenen Inbound- und Bounce-Adressen von Emailit an.
Lösung. Aktivieren Sie die SMTP-Authentifizierung in Ihrem Client und tragen Sie Benutzername und Passwort ein. Prüfen Sie, ob in derselben Sitzung zuvor ein 535 aufgetreten ist.
535 Mail server has been suspended
Ursache. Der Workspace ist gesperrt, meist wegen einer hohen Bounce-Rate. Siehe Versandgesundheit.
Lösung. Kontaktieren Sie den Support unter support@emailit.com. Der Versand wird fortgesetzt, sobald die Sperrung aufgehoben ist.
550 Unverified workspaces can only send to workspace members’ account emails
Ursache. Der Workspace ist im Sandbox-Modus, und der Empfänger ist nicht die Konto-E-Mail-Adresse eines Workspace-Mitglieds. Die Meldung endet mit der blockierten Adresse.
Lösung. Testen Sie mit der Konto-E-Mail-Adresse eines Mitglieds oder beantragen Sie den Produktionszugang. Siehe Wie teste ich den Versand, bevor mein Workspace verifiziert ist?.
Nachrichtenfehler
Diese Fehler treten auf, nachdem Ihr Client die Nachricht mit DATA gesendet hat.
552 Message too large (maximum size 40MB)
Ursache. Die Nachricht ist einschließlich kodierter Anhänge größer als 40 MB. Die Base64-Kodierung macht Anhänge etwa ein Drittel größer als die Dateien.
Lösung. Senden Sie kleinere Anhänge oder laden Sie große Dateien in Ihren eigenen Speicher hoch und fügen Sie einen Link ein.
530 From/Sender domain is not verified for this workspace
Ursache. Eine Adresse im Header From liegt nicht auf einer verifizierten Versanddomain des Workspaces, dem der Schlüssel gehört. Häufige Gründe: Die Domain ist noch nicht verifiziert oder wartet auf die Prüfung, die Absenderadresse liegt auf einer Subdomain, die Sie nicht hinzugefügt haben, der Schlüssel gehört zu einem anderen Workspace, oder die Nachricht hat keinen Header From. Die Envelope-Adresse in MAIL FROM spielt keine Rolle.
Lösung. Prüfen Sie den Status der Domain unter Email APIDomains, sorgen Sie dafür, dass die Absenderadresse genau zu einer verifizierten Domain passt, und verwenden Sie einen Schlüssel aus demselben Workspace. Siehe Warum gibt SMTP 530 From domain not verified zurück?.
530 API key is restricted to sending domain
Ursache. Der Schlüssel ist ein Schlüssel mit Sending Only, der auf eine Domain beschränkt ist, und die Absenderadresse liegt auf einer anderen Domain. Die Meldung nennt die erlaubte Domain.
Lösung. Senden Sie von der erlaubten Domain oder verwenden Sie einen Schlüssel ohne Domainbeschränkung.
550 Sending from this domain is paused
Ursache. Emailit hat die Absenderdomain pausiert, weil ihre Bounce-Rate über 5 % lag.
Lösung. Finden Sie die Ursache der Bounces und bereinigen Sie Ihre Liste. Siehe Versandgesundheit und Bounces und Beschwerden.
550 Loop detected
Ursache. Die Nachricht hat das Relay von Emailit bereits mehr als viermal durchlaufen, meist weil Weiterleitungsregeln sie hin und her schicken.
Lösung. Finden und durchbrechen Sie die Weiterleitungsschleife zwischen Ihren Systemen oder Postfächern.
550 Message processing failed
Ursache. Emailit hat die Daten angenommen, konnte die Nachricht aber nicht speichern.
Lösung. Senden Sie die Nachricht erneut. Schlägt es wieder fehl, kontaktieren Sie den Support und nennen Sie den Zeitpunkt des Versuchs sowie die Absender- und Empfängeradressen.
Fehler bei eingehenden E-Mails
452 Insufficient credits to receive inbound email
Ursache. Eine Nachricht wurde an eine Ihrer Inbound-Adressen gesendet, aber der Workspace hat keine Credits mehr. Der Empfang einer E-Mail kostet 1 Credit. Der sendende Server erhält diesen vorübergehenden Fehler und versucht es später erneut.
Lösung. Laden Sie Ihre Credits auf oder aktivieren Sie die automatische Aufladung. E-Mails, die der Absender erneut sendet, kommen an, sobald Credits verfügbar sind.
Verbindungsprobleme
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Die Verbindung läuft in ein Timeout oder wird abgelehnt | Ihr Internet-, Hosting- oder Cloud-Anbieter blockiert den Port. Port 25 ist auf den meisten Cloud-Plattformen blockiert, manche blockieren auch 587. | Verwenden Sie 587, dann 2525 oder 2587. Siehe Warum läuft meine SMTP-Verbindung in ein Timeout?. |
wrong version number, oder die Verbindung hängt nach dem Verbindungsaufbau |
Der TLS-Modus passt nicht zum Port: implizites TLS auf 587 oder STARTTLS auf 465. | Verwenden Sie STARTTLS auf 587, 2525, 2587 und 25 und implizites TLS nur auf 465. |
| Zertifikatsname stimmt nicht überein | Sie verbinden sich über eine IP-Adresse oder Ihren eigenen Hostnamen. | Verbinden Sie sich mit smtp.emailit.com. |
| Handshake schlägt auf einem alten System fehl | Der Client kann keine moderne TLS-Version aushandeln, oder seine CA-Zertifikate sind veraltet. | Aktualisieren Sie Laufzeitumgebung, OpenSSL und CA-Bundle. |
Mehr Details finden Sie unter Warum erhalte ich TLS-Fehler beim Verbinden mit SMTP?.
Angenommen, aber nicht zugestellt
Eine Antwort 250 bedeutet, dass Emailit die Nachricht angenommen hat, nicht dass sie im Posteingang angekommen ist. Öffnen Sie die E-Mail unter Email APIEmails mit der ID aus der Antwort und prüfen Sie ihren Status:
- Held: Dem Workspace sind die Credits ausgegangen, die Domain wurde pausiert, oder die Nachricht hat bei den Spam-Prüfungen einen Score von 7 oder mehr erreicht. Beheben Sie die Ursache und senden Sie sie dann erneut. Siehe Warum wird meine E-Mail zurückgehalten?.
- Suppressed: Der Empfänger steht auf Ihrer Sperrliste.
- Attempted: Der Server des Empfängers hat einen vorübergehenden Fehler zurückgegeben. Emailit versucht es etwa 21 Stunden lang erneut.
- Bounced oder Failed: Die Zustelldetails zeigen die Antwort des Empfangsservers. Siehe Bounces und Beschwerden.
Eine vollständige Checkliste finden Sie unter Warum ist meine E-Mail nicht angekommen?.
Weiterhin Probleme?
Schreiben Sie an support@emailit.com oder fragen Sie auf Discord. Nennen Sie den Zeitpunkt des Versuchs, den Port, Ihre Mail-Bibliothek und die vollständige Antwort des Servers.