Hatalar, zaman aşımları ve yeniden denemeler

invoke, { data, error } değerini döndürür ve asla fırlatmaz. error bir AuraError olduğundan isAuraError(error) doğrudur. İki alt sınıf size kimin başarısız olduğunu söyler:

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

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

if (error instanceof FunctionsHttpError) {
  // İşleviniz bir hata durumuyla yanıt verdi. Kodunuzda hata ayıklayın.
} else if (error instanceof FunctionsRelayError) {
  // Platform başarısız oldu: işlevinizin yanıtı asla geri gelmedi.
} else if (error) {
  // Çağrı istemcide iptal edildi veya reddedildi (zaman aşımı, geçersiz_body, no_session).
}

Çalışan bir yığına karşı gözlemlenen davranışlar. Kota satırı, arka ucun hata eşlemesini takip eder ve testlerimizde tetiklenmemiştir.

SDK hiçbir zaman sizin için bir çağrıyı yeniden denemez: işlevinizin yan etkileri olabilir ve tekrarlanan POST varsayılan olarak güvenli değildir. Aşağıdaki tabloyu kullanarak siz karar verin.

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

Üç saat aynı anda çalışır:

İşlev timeout_secs değerini aştığında, çalışma zamanı onu iptal eder ve yukarıda gösterilen 500 veya 503 ile yaklaşık bu gecikmeden sonra çağrınız başarısız olur. Nedeni ham modda error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) içinde görünüyor. Bu hatayı görmek için timeout istemcisi yerine istemcinizi timeout işlevin timeout_secs biraz üstüne ayarlayın.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Müşteriniz tarafından iptal edildi. İşlev hâlâ çalışıyor olabilir.
}

Birkaç saniyeden uzun bir çalışma için, bağlantıyı açık tutmak yerine işini kuyruğa alın.

• Platform hataları bir istek kimliği taşır: error.details.error.request_id. Destek ekibiyle iletişime geçtiğinizde bunu alıntılayın.
• aura functions logs <name> en son HTTP isteklerini yöntem, yol, durum, süre ve istek kimliğiyle birlikte listeler. işlevinizin console.log veya console.error ile ne yazdığını göstermez: çıktı, yalnızca platform operatörünün okuyabileceği çalışma zamanının kendi günlüklerinde kalır. Bu ve diğer mevcut boşluklar için sınırlarına bakın.
• Çağrının tanımlayıcısı işlevinize iletilmez. Kendi kimliğinizi headers içine iletin ve günlüğe kaydedin.