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áciaOdporúčané postupydôvod
Dočasné preťaženie službyOhraničený ústup, obmedzený počet časov a celkový čas čakaniaVyhnite sa intenzívnemu opakovaniu všetkých úloh súčasne
Neplatné prihlásenie alebo povolenieVyzvať používateľa na opätovné autorizovanieOpakované používanie starých poverení bude naďalej neúspešné
Nenormálnosť účtu alebo faktúryzastaviť a nahlásiťNemalo by dochádzať k automatickým dobíjaniam ani zmenám účtu
Chyba vstupnej štruktúryNechajte používateľa opraviť vstupNemá zmysel znova posielať presne ten istý súbor
Časový limit žiadosti POST vypršalNajprv 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-After vrá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é akcieby sa štandardne nemalo robiť
dočasné preťaženieohraničená evakuáciaVšetky úlohy sú súčasne intenzívne opätovne vydávané
Neplatné prihlásenie alebo povolenieVýslovná výzva na opätovnú autorizáciuStále opakujte staré poverenia
Nenormálnosť účtu alebo faktúryzastaviť a nahlásiťAutomaticky dobíjajte alebo zmeňte účty
Chyba vstupnej štruktúryNechajte používateľa opraviť vstupZnova 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é úlohyjedna užívateľská operáciaZodpovedá rovnakej požiadavke, akú vidí používateľ
skúste nahraťČas spustenia, kategória zlyhania, ID vzdialenej úlohyPoužíva sa na riešenie problémov s procesom opakovania
Výsledky prijatiaVý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

Aktualizované 2026-11-17