Il 428 richiede una modifica condizionale della risorsa. Usa il validatore della versione che hai letto, senza sovrascrivere aggiornamenti altrui.
Indice dei contenuti
Errore 428 Precondition Required: significato
Manca la condizione richiesta dal contratto API. Il client non conserva il validatore della versione letta. Un intermediario rimuove l’header condizionale.
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
- Manca la condizione richiesta dal contratto API.
- Il client non conserva il validatore della versione letta.
- Un intermediario rimuove l’header condizionale.
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
- Leggi nella risposta quale condizione richiede l’API, per esempio If-Match.
- Confronta i dati locali con la versione corrente prima di preparare il nuovo aggiornamento.
- Invia il validatore previsto e gestisci separatamente il 412, che indica una precondizione non soddisfatta.
- Non recuperare un nuovo ETag solo per forzare l’invio di dati vecchi. Le risposte 428 non devono essere memorizzate dalla cache.
Verifica finale
- Gli aggiornamenti corretti riescono e quelli su versioni obsolete non sovrascrivono dati.
- Confronta il risultato con la prova iniziale e conserva gli eventuali errori rimasti.
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”?
Il 428 richiede una modifica condizionale della risorsa. Usa il validatore della versione che hai letto, senza sovrascrivere aggiornamenti altrui.
Da cosa può dipendere “Errore 428 Precondition Required”?
Manca la condizione richiesta dal contratto API. Il client non conserva il validatore della versione letta. Un intermediario rimuove l’header condizionale.
Quali controlli eseguire per “Errore 428 Precondition Required”?
Leggi nella risposta quale condizione richiede l’API, per esempio If-Match. Confronta i dati locali con la versione corrente prima di preparare il nuovo aggiornamento. Invia il validatore previsto e gestisci separatamente il 412, che indica una precondizione non soddisfatta. Non recuperare un nuovo ETag solo per forzare l’invio di dati vecchi. Le risposte 428 non devono essere memorizzate dalla cache.