त्रुटियाँ, समयबाह्य और पुनः प्रयास

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) {
  // क्लाइंट पर कॉल रद्द कर दी गई या अस्वीकार कर दी गई (टाइमआउट, अमान्य_बॉडी, नो_सेशन)।
}

चल रहे स्टैक के विरुद्ध व्यवहार का अवलोकन किया गया। कोटा पंक्ति बैकएंड की त्रुटि मैपिंग का अनुसरण करती है और हमारे परीक्षणों में ट्रिगर नहीं हुई थी।

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 को फ़ंक्शन के timeout_secs से थोड़ा ऊपर सेट करें।

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 में अपनी खुद की आईडी पास करें और लॉग इन करें।