Errore SMTP 501 Syntax error in parameters or arguments

In breve: L’errore SMTP 501 Syntax error indica che il server SMTP ha ricevuto un comando o un parametro con sintassi non valida.

Che cosa significa

Il codice SMTP 501 appartiene agli errori permanenti della famiglia 5xx e segnala che la struttura di un comando oppure uno dei suoi argomenti non rispetta il formato atteso dal server. La sessione può essere già connessa e autenticata correttamente, ma l’invio viene rifiutato quando il server analizza HELO, MAIL FROM, RCPT TO o un parametro ESMTP.

Il testo che segue il codice è essenziale. Messaggi come syntax error in parameters or arguments, bad address syntax o riferimenti a MAIL FROM e RCPT TO indicano punti differenti della conversazione SMTP. Prima di modificare DNS, password o porte bisogna individuare il comando preciso che ha generato la risposta.

Come riconoscere il problema

• Il bounce o il log contiene il codice 501.
• Il testo cita syntax error, bad address syntax o invalid argument.
• L’invio fallisce soltanto da un plugin, un gestionale o un modulo di contatto.
• La Webmail invia correttamente con la stessa casella.
• Uno specifico mittente, destinatario o campo del form fa comparire l’errore.

Non confondere il codice 501 con un problema generico di consegna. Un errore DNS del destinatario, una quota piena o un blocco antispam producono normalmente risposte differenti. Nel 501 il server segnala esplicitamente che non riesce ad accettare la forma del comando ricevuto.

Cause più frequenti

1. Indirizzo email con sintassi non valida

Mittente o destinatario contiene spazi, parentesi non ammesse, caratteri invisibili, una chiocciola mancante oppure un dominio incompleto. Per confermare questa causa confronta il valore originale con quello registrato nella sessione SMTP o nel log. Non correggere più campi contemporaneamente: modifica un solo elemento e ripeti lo stesso invio.

2. Comando MAIL FROM o RCPT TO costruito male

Un’applicazione, un plugin SMTP o uno script genera il comando con delimitatori errati, parentesi angolari mancanti o parametri aggiuntivi non supportati.

3. HELO o EHLO non conforme

Il client si presenta con un hostname vuoto, non valido o formato in modo non conforme e il server rifiuta la sessione prima dell’invio.

4. Header o envelope sender confusi

Il campo From visibile può essere corretto mentre l’envelope sender usato nella busta SMTP contiene una sintassi differente o un valore vuoto.

5. Plugin, modulo di contatto o gestionale

Il software inserisce dati non sanificati provenienti da un form, concatena più indirizzi in modo errato o usa una libreria SMTP obsoleta.

6. Caratteri copiati o codifica anomala

Virgolette tipografiche, spazi non separabili, ritorni a capo e caratteri Unicode invisibili possono rendere non valido un parametro apparentemente corretto.

7. Parametro ESMTP non supportato

Il client invia opzioni come SIZE, BODY, SMTPUTF8 o altri parametri con formato errato oppure non compatibile con il server raggiunto.

Diagnosi passo per passo

1. Conservare la risposta SMTP completa e il comando rifiutato. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
2. Identificare se l’errore avviene su HELO, MAIL FROM o RCPT TO. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
3. Controllare mittente e destinatario carattere per carattere. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
4. Confrontare header From ed envelope sender. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
5. Provare l’invio dalla Webmail con gli stessi indirizzi. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
6. Controllare log Exim o Track Delivery nello stesso minuto. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
7. Disattivare soltanto il plugin o l’integrazione sospetta in staging. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.
8. Riprodurre la sessione con un client SMTP conforme. Esegui il controllo nello stesso ambiente che genera l’errore e registra data, ora e risultato. Quando confronti indirizzi e comandi, visualizza anche caratteri invisibili e delimitatori; una rappresentazione grafica normale può nascondere lo spazio o il ritorno a capo responsabile.

Procedura di risoluzione

1. Correggere la sintassi dell’indirizzo coinvolto. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
2. Usare username e dominio completi senza spazi o caratteri invisibili. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
3. Correggere MAIL FROM, RCPT TO e parentesi angolari nel codice personalizzato. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
4. Impostare un hostname valido per HELO o EHLO. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
5. Allineare envelope sender e mittente autorizzato. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
6. Aggiornare plugin, libreria SMTP o gestionale. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
7. Sanificare e validare i campi provenienti dai form. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
8. Rimuovere parametri ESMTP non validi o correggerne il formato. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.
9. Ritestare con Webmail, applicazione e destinatari differenti. Applica la correzione soltanto al componente confermato, conserva il valore precedente e invia un nuovo messaggio di prova. Controlla il nuovo Message-ID e la nuova sessione nei log per evitare di confondere il risultato con un tentativo precedente.

Domande frequenti

Guide Xlogic correlate

• Errore SMTP 554 Too many hops
• Errore SMTP 553 Sender address rejected
• SPF PermError: too many DNS lookups