Błędy, przekroczenia limitu czasu i ponowne próby

invoke zwraca { data, error } i nigdy nie rzuca. error to AuraError, więc isAuraError(error) jest prawdą. Dwie podklasy informują , kto zawiódł:

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

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

if (error instanceof FunctionsHttpError) {
  // Twoja funkcja odpowiedziała ze statusem błędu. Debuguj swój kod.
} else if (error instanceof FunctionsRelayError) {
  // Platforma zawiodła: odpowiedź Twojej funkcji nigdy nie wróciła.
} else if (error) {
  // Połączenie zostało anulowane lub odrzucone przez klienta (timeout, valid_body, no_session).
}

Zachowania zaobserwowane w przypadku działającego stosu. Wiersz przydziału jest zgodny z mapowaniem błędów zaplecza i nie został wywołany w naszych testach.

SDK nigdy nie ponawia próby wywołania: Twoja funkcja może mieć skutki uboczne, a powtarzające się POST domyślnie nie jest bezpieczne. Ty decydujesz, korzystając z poniższej tabeli.

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

Trzy zegary działają jednocześnie:

Gdy funkcja przekracza timeout_secs, środowisko wykonawcze ją anuluje, a wywołanie kończy się niepowodzeniem po mniej więcej tym opóźnieniu, z wartością 500 lub 503 pokazaną powyżej. Przyczyna pojawia się w error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) w trybie surowym. Ustaw swojego klienta timeout nieco powyżej timeout_secs funkcji, aby zobaczyć ten błąd zamiast klienta timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Anulowane przez Twojego klienta. Funkcja może nadal działać.
}

W przypadku pracy dłuższej niż kilka sekund wstaw zadanie do kolejki zamiast utrzymywać otwarte połączenie.

• Błędy platformy mają identyfikator żądania: error.details.error.request_id. Podaj go, kontaktując się z pomocą techniczną.
• aura functions logs <name> wyświetla listę ostatnich żądań HTTP z metodą, ścieżką, statusem, czasem trwania i identyfikatorem żądania. To , a nie pokazuje, co napisała twoja funkcja za pomocą console.log lub console.error: dane wyjściowe pozostają we własnych dziennikach środowiska wykonawczego, które może odczytać tylko operator platformy. Zobacz limity dla tej i innych przerw bieżących.
• Identyfikator wywołania nie jest przekazywany do Twojej funkcji. Podaj swój własny identyfikator w headers i zaloguj go.