Ak rozhranie hlási chybu, skúste to znova? Úlohy dokumentácie by mali najprv rozlíšiť, ktoré zlyhania je možné opraviť
Po nahlásení chyby je veľmi bežné skúsiť to znova. Nekonečné pokusy po nahlásení chyby zosilnia menšie chyby. Chyby povolení, delikvencie účtov, poškodené súbory a dočasné zaneprázdnené služby by nemali nasledovať rovnakú cestu opakovania. Po kategorizácii sa rozhodnite, ako dlho sa bude čakať, koľkokrát najviac pokusov a či je potrebný zásah používateľa.
Opakovať pokus po nahlásení chyby je bežnou praxou, ale ak to budete opakovať donekonečna bez rozdielu, chyby sa môžu zväčšiť. Chyby povolení, delikvencie účtov, poškodené súbory a dočasne zaneprázdnené služby by sa mali riešiť inak.
Tento článok je vhodný pre vývojárov a študentov produktov, ktorí vykonávajú asynchrónne úlohy, ako je preklad a konverzia dokumentov. Po prečítaní tohto si môžete najprv kategorizovať zlyhania a potom sa rozhodnúť, ako dlho budete čakať, koľko pokusov najviac a kedy je potrebný zásah používateľa.
Nižšie uvedený kód a postup sú založené na syntetických vzorkách, ktoré boli testované v izolovanom prostredí. Nepredstavujú záruku všetkých autentických dokumentov alebo účinkov produktu. Pred spracovaním dôležitých dokumentov si originály uschovajte a skontrolujte ich podľa hraníc a akceptačných položiek v texte.
Ako to skúsiť znova, keď úloha dokumentu ohlási chybu? Záver jednou vetou
Najprv klasifikujte zlyhanie pred rozhodnutím, či to skúsiť znova: dočasné zlyhania sú ohraničené a stiahnuté, problémy s povoleniami a účtom sú zastavené a odovzdané používateľovi a chyby zadávania sú ponechané na opravu.
| vaša situácia | Odporúčané postupy | dôvod |
|---|---|---|
| Dočasné preťaženie služby | Ohraničený ústup, obmedzený počet časov a celkový čas čakania | Vyhnite sa intenzívnemu opakovaniu všetkých úloh súčasne |
| Neplatné prihlásenie alebo povolenie | Vyzvať používateľa na opätovné autorizovanie | Opakované používanie starých poverení bude naďalej neúspešné |
| Nenormálnosť účtu alebo faktúry | zastaviť a nahlásiť | Nemalo by dochádzať k automatickým dobíjaniam ani zmenám účtu |
| Chyba vstupnej štruktúry | Nechajte používateľa opraviť vstup | Nemá zmysel znova posielať presne ten istý súbor |
| Časový limit žiadosti POST vypršal | Najprv skontrolujte, či rozhranie podporuje idempotentné kľúče alebo úlohy. | Ak klient nedostane odpoveď, neznamená to, že server nevytvoril úlohu. |
Najprv určite, či opätovný pokus vygeneruje duplicitné úlohy.
Časové limity POST sú obzvlášť problematické. Ak klient nedostane odpoveď, neznamená to, že server nevytvoril úlohu. Ak rozhranie nemá idempotentné kľúče a nemá mechanizmus dopytovania úloh, opätovné odoslanie naslepo môže vytvoriť viacero úloh prekladu.
Stratégia opakovaného pokusu by sa preto mala najskôr riadiť zmluvou rozhrania namiesto toho, aby sa pozerala len na stavový kód HTTP.
Napíšte počet krát a čakací rozpočet ako čisté funkcie
from enum import Enum
class Failure(Enum):
TRANSIENT = "transient"
AUTH = "auth"
BILLING = "billing"
INVALID_INPUT = "invalid_input"
def delay_for(kind, attempt, replay_safe):
if type(attempt) is not int or attempt < 0:
raise ValueError("invalid attempt")
if not replay_safe or kind is not Failure.TRANSIENT:
return None
schedule = (1, 2, 4)
return schedule[attempt] if attempt < len(schedule) else None
assert delay_for(Failure.TRANSIENT, 0, True) == 1
assert delay_for(Failure.TRANSIENT, 2, True) == 4
assert delay_for(Failure.TRANSIENT, 3, True) is None
assert delay_for(Failure.TRANSIENT, 0, False) is None
assert delay_for(Failure.BILLING, 0, True) is None
assert delay_for(Failure.INVALID_INPUT, 0, True) is None
Tento kód iba vypočíta plán opakovania, v skutočnosti nečaká a neposiela požiadavky. Pevná jedna, dve a štyri sekundy sú hodnoty syntetickej demonštrácie a nie sú všeobecnými servisnými odporúčaniami.
Produkčné prostredia musia tiež zvážiť nasledujúce body:
Retry-Aftervrátené serverom- Náhodné chvenie, aby ste sa vyhli pokračovaniu veľkého počtu úloh súčasne
- Celkový termín
- Obmedzenie počtu súbežností
Ak čakacia doba požadovaná serverom presiahne miestny rozpočet, mal by prestať opakovať pokus namiesto toho, aby spustil požiadavku vopred.
Typy chýb zodpovedajú rôznym akciám
| zlyhať | Voliteľné akcie | by sa štandardne nemalo robiť |
|---|---|---|
| dočasné preťaženie | ohraničená evakuácia | Všetky úlohy sú súčasne intenzívne opätovne vydávané |
| Neplatné prihlásenie alebo povolenie | Výslovná výzva na opätovnú autorizáciu | Stále opakujte staré poverenia |
| Nenormálnosť účtu alebo faktúry | zastaviť a nahlásiť | Automaticky dobíjajte alebo zmeňte účty |
| Chyba vstupnej štruktúry | Nechajte používateľa opraviť vstup | Znova odošlite presne ten istý súbor |
Uložte logické úlohy a skúste záznamy
Užívateľská operácia zodpovedá logickej úlohe a v rámci tejto logickej úlohy môže byť viacero pokusov. Pre každý pokus sa zaprotokoluje čas spustenia, kategória zlyhania a ID vzdialenej úlohy. Nakoniec sa vyberie iba jeden akceptovaný výsledok.
Výhodou je, že pri riešení problémov s opakovaným pokusom existuje kompletný záznam a zároveň sa počet pokusov neprepočítava na počet požiadaviek používateľov.
📊 Základné porovnanie
| koncepcie | Čo zaznamenať | účinok |
|---|---|---|
| Logické úlohy | jedna užívateľská operácia | Zodpovedá rovnakej požiadavke, akú vidí používateľ |
| skúste nahrať | Čas spustenia, kategória zlyhania, ID vzdialenej úlohy | Používa sa na riešenie problémov s procesom opakovania |
| Výsledky prijatia | Výstup, ktorý bol prijatý | V dôsledku konečnej dodávky |
Stabilita prekladového zážitku pochádza z jasných vysvetlení
Pri pripájaní k OmniDoc by klientske rozhranie malo jasne informovať používateľa o aktuálnom stave: či čaká, potrebuje opätovnú autorizáciu alebo potrebuje skontrolovať účet. Nezobrazujte všetko ako „Budova".
Používatelia sú ochotní čakať na úlohu so stavom a ukončením, ale nie sú ochotní opakovane klikať na tlačidlo bez akejkoľvek spätnej väzby.
Zdroje: Python enum.
🎯 Ktorá metóda je pre vás vhodná?
Ak čakáte na obnovenie služby
Použite ohraničené stiahnutie, nastavte maximálny počet opakovaní a celkový čas čakania a rešpektujteRetry-After servera.
Ak máte problémy s povolením alebo účtom
Zastavte automatické pokusy a požiadajte používateľa o opätovnú autorizáciu alebo kontrolu stavu účtu.
Ak je štruktúra vášho vstupného súboru nesprávna
Nechajte používateľa opraviť súbor pred jeho odoslaním. Neposielajte znova ten istý súbor.
Ak je rozhranie, ktoré voláte, POST a môže uplynúť časový limit
Najprv potvrďte, či rozhranie podporuje idempotentné kľúče alebo úlohy, a potom sa rozhodnite, či chcete znova odoslať.
❓ Často kladené otázky (FAQ)
1. Je možné všetky nahlásené chyby priamo zopakovať?
nemôžem. Chyby povolení, nedoplatky na účte, poškodené súbory a dočasné zaneprázdnené služby by sa mali riešiť samostatne. Iba dočasné poruchy sú vhodné na obmedzené stiahnutie.
2. Je možné poslať POST znova priamo po uplynutí časového limitu?
Neodporúča sa posielať znova priamo. Ak klient nedostane odpoveď, neznamená to, že server nevytvoril úlohu. Ak neexistuje idempotentný kľúč alebo mechanizmus dopytovania úloh, môžu sa vyskytnúť duplicitné úlohy.
3. Ako by sa mal určiť počet opakovaní a čakacia doba?
Pevná jedna, dve a štyri sekundy sú len syntetické ukážky. Produkčné prostredia by sa mali určiť pomocou kombinácie Retry-After, náhodného jitteru, celkových termínov a limitov súbežnosti.
4. Ovplyvní počet pokusov štatistiku požiadaviek používateľov?
Nie, stačí zaznamenať používateľskú operáciu ako logickú úlohu a zaznamenať každé opakovanie ako záznam pokusu v rámci úlohy.
📝 Zhrnutie
Kľúčom k opakovaniu nie je skúšať viackrát, ale najprv rozlíšiť typ zlyhania a potom sa rozhodnúť, čo robiť. Chyby, ktoré je možné opraviť, sa opakujú obmedzeným spôsobom a problémy, ktoré vyžadujú ľudskú manipuláciu, sa včas vrátia používateľom.
Skúste to teraz: Odovzdajte dokument a spustite preklad, pričom sa zachová pôvodné rozloženie


