Errori, timeout e tentativi

invoke restituisce { data, error } e non genera mai un'eccezione. error è un AuraError, quindi isAuraError(error) è vero. Due sottoclassi ti dicono chi ha fallito:

import { FunctionsHttpError, FunctionsRelayError } from '@aurabase/aurabase-js'

const { data, error } = await aura.functions.invoke('checkout', { body })

if (error instanceof FunctionsHttpError) {
  // La tua funzione ha risposto, con uno stato di errore. Esegui il debug del tuo codice.
} else if (error instanceof FunctionsRelayError) {
  // La piattaforma ha fallito: la risposta della tua funzione non è mai arrivata.
} else if (error) {
  // La chiamata è stata annullata o rifiutata sul client (timeout, invalid_body, no_session).
}

Comportamenti osservati rispetto a uno stack in esecuzione. La riga della quota segue la mappatura degli errori del backend e non è stata attivata nei nostri test.

L'SDK non riprova mai un'invocazione per te: la tua funzione potrebbe avere effetti collaterali e un POST ripetuto non è sicuro per impostazione predefinita. Decidi tu, utilizzando la tabella qui sotto.

import { FunctionsRelayError } from '@aurabase/aurabase-js'

async function invokeWithRetry(name: string, body: unknown, attempts = 3) {
  for (let i = 0; i < attempts; i++) {
    const res = await aura.functions.invoke(name, { body })
    const safe = res.error instanceof FunctionsRelayError && res.error.status === 503
    if (!res.error || !safe) return res
    await new Promise((r) => setTimeout(r, 2 ** i * 500))
  }
  return aura.functions.invoke(name, { body })
}

Tre orologi funzionano contemporaneamente:

Quando la funzione supera timeout_secs, il runtime la annulla e la chiamata fallisce dopo circa quel ritardo, con il 500 o 503 mostrato sopra. La causa viene visualizzata in error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) in modalità raw. Imposta il tuo client timeout leggermente sopra timeout_secs della funzione per visualizzare questo errore invece di un client timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Annullato dal tuo cliente. La funzione potrebbe essere ancora in esecuzione.
}

Per lavori che durano più di qualche secondo, accoda un lavoro invece di tenere aperta una connessione.

• Gli errori della piattaforma contengono un ID richiesta: error.details.error.request_id. Citalo quando contatti l'assistenza.
• aura functions logs <name> elenca le richieste HTTP recenti con metodo, percorso, stato, durata e ID richiesta. non mostra ciò che la tua funzione ha scritto con console.log o console.error: quell'output rimane nei log del runtime, che solo l'operatore della piattaforma può leggere. Vedi limiti per questo e gli altri gap attuali.
• L'identificativo della chiamata non viene inoltrato alla vostra funzione. Passa il tuo ID in headers e accedi.