In breve: Errore 428 Precondition Required — indica che il server richiede una condizione come If-Match prima di accettare una modifica alla risorsa.
Indice dei contenuti
Errore 428 Precondition Required: significato
Le prime ipotesi da verificare per “Errore 428 Precondition Required” sono header condizionale assente; ETag non salvato dal client.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “errore 428 Precondition Required” compare durante un’operazione ripetibile.
- La funzione coinvolta in HTTP, browser e API non raggiunge il risultato previsto.
- Il log dell’area HTTP, browser e API registra un evento nello stesso minuto della prova.
- Il comportamento osservato in HTTP, browser e API cambia in base a utente, rete, file o configurazione.
Cause probabili
- Header condizionale assente
- ETag non salvato dal client
- Risorsa modificata da un altro processo
- Proxy che rimuove If-Match
Diagnosi passo per passo
- Recuperare ETag o Last-Modified corrente
- Controllare gli header effettivamente inviati
- Confrontare versione locale e remota
- Verificare intermediari che filtrano header
- Riprodurre l’aggiornamento su un oggetto di test
Log e dati da controllare
- DevTools, scheda Network
- log del server web o dell’applicazione
- log di proxy, CDN o WAF
Correzioni sicure
- Inviare If-Match con il validatore corrente
- Gestire esplicitamente i conflitti di versione
- Non sovrascrivere dati più recenti
- Preservare gli header condizionali nei proxy
- Aggiornare il client al contratto API corrente
Verifica finale
- La stessa richiesta riceve la risposta prevista
- Metodo, header e corpo sono coerenti
- Non compaiono redirect o tentativi inattesi
- I log confermano il medesimo esito
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- Errore 402 Payment Required: significato e soluzioni
- Errore 205 Reset Content: significato e soluzioni
- Errore 303 See Other: redirect dopo POST
Fonti tecniche
Domande frequenti
Che cosa significa “Errore 428 Precondition Required”?
Errore 428 Precondition Required — indica che il server richiede una condizione come If-Match prima di accettare una modifica alla risorsa.
Da cosa può dipendere “Errore 428 Precondition Required”?
Le cause da verificare per “Errore 428 Precondition Required” sono: header condizionale assente; ETag non salvato dal client; risorsa modificata da un altro processo.
Quali controlli eseguire per “Errore 428 Precondition Required”?
Per diagnosticare “Errore 428 Precondition Required”, controlla nell’ordine: recuperare ETag o Last-Modified corrente; controllare gli header effettivamente inviati; confrontare versione locale e remota. La soluzione è confermata quando la stessa richiesta riceve la risposta prevista; metodo, header e corpo sono coerenti.