Ошибки, тайм-ауты и повторные попытки

invoke возвращает { data, error } и никогда не выдает исключение. error — это AuraError, поэтому isAuraError(error) истинно. Два подкласса сообщают , кто провалил:

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

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

if (error instanceof FunctionsHttpError) {
  // Ваша функция ответила со статусом ошибки. Отладка вашего кода.
} else if (error instanceof FunctionsRelayError) {
  // Платформа вышла из строя: ответ вашей функции так и не пришел.
} else if (error) {
  // Вызов был отменен или отклонен на клиенте (тайм-аут, инвалид_боди, no_session).
}

Поведение, наблюдаемое в отношении работающего стека. Строка квоты соответствует сопоставлению ошибок серверной части и не сработала в наших тестах.

SDK никогда не повторяет вызов за вас: ваша функция может иметь побочные эффекты, а повторный вызов POST по умолчанию небезопасен. Решать вам, используя таблицу ниже.

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

Три часа идут одновременно:

Когда функция превышает timeout_secs, среда выполнения отменяет ее, и ваш вызов завершается неудачей примерно после этой задержки с кодом 500 или 503, показанным выше. Причина отображается в error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) в необработанном режиме. Установите клиент timeout немного выше timeout_secs функции, чтобы увидеть эту ошибку вместо клиента timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Отменено вашим клиентом. Возможно, функция все еще работает.
}

Для работы продолжительностью более нескольких секунд ставит задание в очередь вместо того, чтобы удерживать соединение открытым.

• Ошибки платформы содержат идентификатор запроса: error.details.error.request_id. Укажите его при обращении в службу поддержки.
• aura functions logs <name> перечисляет последние HTTP-запросы с указанием метода, пути, статуса, продолжительности и идентификатора запроса. , а не, показывает то, что ваша функция написала с помощью console.log или console.error: этот вывод остается в собственных журналах среды выполнения, которые может прочитать только оператор платформы. См. ограничения для этого и других текущих разрывов.
• Идентификатор вызова не пересылается в вашу функцию. Передайте свой идентификатор в headers и зарегистрируйте его.