Centro risoluzione errori

Business Central 504 Gateway Timeout: risolvere operazioni API troppo lunghe

Metodi per suddividere le operazioni lunghe, ridurre il volume dei dati e gestire i limiti di richiesta in caso di errore Business Central 504.

Codariva ·

La comparsa di 504 Gateway Timeout in Business Central può essere collegata al raggiungimento del limite di durata della richiesta. Microsoft descrive il limite temporale di alcune chiamate ai servizi web e l'approccio che suddivide le operazioni lunghe in parti più piccole.

Diagnosi iniziale

Individua l'operazione che genera l'errore: lettura di tutte le giacenze, trasferimento di un ordine grande o aggiornamento di molti record? L'errore si ripete con un record o filtro specifico? Registra la durata della chiamata e i filtri interessati.

Approccio alla correzione

  1. Riduci il perimetro: Non richiedere colonne e record non necessari; usa la paginazione quando serve.
  2. Suddividi in parti: Dividi grandi gruppi di dati in attività piccole e tracciabili.
  3. Usa un indicatore di avanzamento: Conserva l'ultimo record elaborato correttamente per evitare di ripartire dall'inizio dopo un'interruzione.
  4. Controlla i nuovi tentativi: Suddividere in troppe parti aumenta il numero di chiamate; potresti così raggiungere il limite 429 .
  5. Rendi visibile lo stato dell'attività: Mostra i record completati e in attesa anziché dire all'utente che tutto è completato.

Differenza tra 429 e 504

429 indica il raggiungimento di un limite di richieste, mentre 504 segnala un timeout. Non è corretto tentare di risolverli con la stessa regola di ripetizione. Per 504 potrebbe essere necessario riprogettare la struttura dell'operazione.

Test di integrazione

Una richiesta veloce con dati esemplificativi può rallentare con i volumi di produzione. Nel test pilota rappresenta quantità di dati, carico di lavoro e utenti contemporanei realistici.

La scrittura può essere avvenuta anche senza risposta?

Sì: il timeout di un gateway intermedio non dimostra che nell'ERP non sia stata eseguita alcuna operazione. Individua prima il livello che ha generato l'errore e il riferimento dell'operazione. Verifica l'esistenza del record prima di ripetere la richiesta di scrittura; se non puoi confermare l'esito, passa alla verifica.

Scenario di esempio: La prima parte di un trasferimento massivo è stata completata, mentre la risposta della seconda è andata persa. Occorre riprendere dall'ultima parte verificata e confrontare i record della seconda. Reinviare l'intero file crea un rischio di duplicati.

Osservazione Il prossimo passo
Anche pochi dati si interrompono dopo lo stesso intervallo Esamina separatamente i limiti temporali di proxy, client ed ERP
Si interrompe solo un filtro ampio Riduci campi e intervallo dei record; verifica la paginazione
Le parti piccole restituiscono 429 Riduci la concorrenza; applica l'approccio per 429.

Per la misurazione sono sufficienti durata, numero di pagina/parte e riferimento dell'operazione; evita di registrare inutilmente dati dei clienti e credenziali.

Quando chiedere supporto all'amministratore?

Se anche una query piccola e in sola lettura va ripetutamente in timeout, individua con gli amministratori del gateway e dell'ERP il livello che genera l'errore. Condividi identificativo dell'operazione depurato, orario, perimetro della query e durata. Assegna alla persona responsabile le operazioni il cui esito di scrittura resta incerto, senza ricrearle automaticamente.

Fonti e verifica

I flussi esemplificativi sono proposte architetturali, non progetti cliente completati né dichiarazioni di partnership con i produttori. Verifica delle fonti tecniche: 17 ottobre 2026. Versione, licenza e autorizzazioni dell'installazione vanno verificate separatamente.

Adatta il flusso alla tua azienda

Consulta la guida alla pianificazione dell'integrazione ERP. Puoi approfondire il perimetro previsto per lo sviluppo software su misura; possiamo valutare insieme il tuo processo attuale.

Parliamo delle tue esigenze →