Fehler, Zeitüberschreitungen und Wiederholungsversuche

invoke gibt { data, error } zurück und löst nie aus. error ist ein AuraError, also ist isAuraError(error) wahr. Zwei Unterklassen sagen Ihnen , wer versagt hat:

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

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

if (error instanceof FunctionsHttpError) {
  // Ihre Funktion hat mit einem Fehlerstatus geantwortet. Debuggen Sie Ihren Code.
} else if (error instanceof FunctionsRelayError) {
  // Die Plattform ist ausgefallen: Die Antwort Ihrer Funktion kam nie zurück.
} else if (error) {
  // Der Anruf wurde auf dem Client abgebrochen oder abgelehnt (Timeout, invalid_body, no_session).
}

Beobachtete Verhaltensweisen gegenüber einem laufenden Stapel. Die Kontingentzeile folgt der Fehlerzuordnung des Backends und wurde in unseren Tests nicht ausgelöst.

Das SDK wiederholt niemals einen Aufruf für Sie: Ihre Funktion kann Nebenwirkungen haben und ein wiederholtes POST ist standardmäßig nicht sicher. Sie entscheiden anhand der folgenden Tabelle.

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 })
}

Drei Uhren laufen gleichzeitig:

Wenn die Funktion timeout_secs überschreitet, wird sie von der Laufzeit abgebrochen und Ihr Aufruf schlägt nach etwa dieser Verzögerung fehl, mit den oben gezeigten 500 oder 503. Die Ursache erscheint in error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) im Rohmodus. Stellen Sie Ihren Client timeout etwas über dem timeout_secs der Funktion ein, um diesen Fehler anstelle eines Clients timeout anzuzeigen.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Von Ihrem Kunden storniert. Möglicherweise läuft die Funktion noch.
}

Für Arbeiten, die länger als ein paar Sekunden dauern, einen Job in die Warteschlange einreihen, anstatt eine Verbindung offen zu halten.

• Plattformfehler tragen eine Anforderungs-ID: error.details.error.request_id. Geben Sie es an, wenn Sie den Support kontaktieren.
• aura functions logs <name> listet aktuelle HTTP-Anfragen mit Methode, Pfad, Status, Dauer und Anfrage-ID auf. Es zeigt nicht an, was Ihre Funktion mit console.log oder console.error geschrieben hat: Diese Ausgabe bleibt in den eigenen Protokollen der Laufzeit, die nur der Plattformbetreiber lesen kann. Siehe -Grenzwerte für diese und die anderen aktuellen Lücken.
• Die Kennung des Aufrufs wird nicht an Ihre Funktion weitergeleitet. Übergeben Sie Ihre eigene ID in headers und protokollieren Sie sie.