Ha az interfész hibát jelez, próbálja újra? A dokumentációs feladatoknak először meg kell különböztetniük, mely hibákat lehet helyreállítani

Nagyon gyakori, hogy a hiba bejelentése után újra próbálkoznak. Ha a hiba bejelentése után végtelenül újra próbálkozik, az felerősíti a kisebb hibákat. Az engedélyhibák, a fiókhibák, a sérült fájlok és az ideiglenesen foglalt szolgáltatások nem követhetik ugyanazt az újrapróbálkozási útvonalat. A kategorizálás után döntse el, hogy mennyi ideig kell várni, legfeljebb hány próbálkozás, és szükség van-e felhasználói beavatkozásra.

A hibajelentés utáni újrapróbálkozás bevett gyakorlat, de ha határozatlan ideig válogatás nélkül próbálkozik újra, a hibák felnagyíthatók. Az engedélyhibákat, a fiókhibákat, a sérült fájlokat és az ideiglenesen foglalt szolgáltatásokat másként kell kezelni.

Ez a cikk azoknak a fejlesztőknek és termékhallgatóknak szól, akik aszinkron feladatokat végeznek, például dokumentumok fordítását és konvertálását. Ennek elolvasása után először kategorizálhatja a hibákat, majd eldöntheti, hogy mennyi ideig kell várni, legfeljebb hány próbálkozásra van szükség, és mikor van szükség felhasználói beavatkozásra.

Az alábbi kód és folyamat olyan szintetikus mintákon alapul, amelyeket izolált környezetben teszteltek. Nem jelentenek garanciát minden hiteles dokumentumra vagy termékhatásra. Kérjük, a fontos dokumentumok feldolgozása előtt őrizze meg az eredeti példányokat, és nézze át azokat a szövegben szereplő határok és átvételi tételek szerint.

Hogyan próbálkozz újra, miután a dokumentumfeladat hibát jelez? Egy mondatos következtetés

Először osztályozza a hibát, mielőtt eldönti, hogy újra próbálkozik-e: az ideiglenes hibákat korlátozzák és megszüntetik, az engedélyekkel és fiókokkal kapcsolatos problémákat leállítják és átadják a felhasználónak, a beviteli hibákat pedig a felhasználóra bízzák.

a helyzetedAjánlott gyakorlatokok
Szolgáltatás átmeneti torlódásaKorlátozott visszalépés, korlátozott számú alkalom és teljes várakozási időKerülje el az összes feladat egyidejű intenzív újrakiadását
A bejelentkezés vagy az engedély érvénytelenKérje meg a felhasználót az újbóli engedélyezésreA régi hitelesítő adatok újra és újra felhasználása továbbra is sikertelen lesz
Számla- vagy számlarendellenességállj meg és jelentsNem szabad automatikus feltöltést vagy fiókmódosítást végrehajtani
Bemeneti szerkezeti hibaHagyja, hogy a felhasználó javítsa a bemenetetNincs értelme pontosan ugyanazt a fájlt újraküldeni
POST kérés időtúllépéseElőször ellenőrizze, hogy az interfész támogatja-e az idempotens kulcsokat vagy a feladatlekérdezéseket.Ha az ügyfél nem kap választ, az nem jelenti azt, hogy a szerver nem hozott létre feladatot.

Először határozza meg, hogy az újrapróbálkozás nem generál-e ismétlődő feladatokat.

A POST időtúllépései különösen zavaróak. Ha az ügyfél nem kap választ, az nem jelenti azt, hogy a szerver nem hozott létre feladatot. Ha az interfész nem rendelkezik idempotens kulcsokkal és nem rendelkezik feladatlekérdezési mechanizmussal, a vak újraküldés több fordítási feladatot is létrehozhat.

Ezért az újrapróbálkozási stratégiának először az interfész-szerződést kell követnie, ahelyett, hogy csak a HTTP állapotkódot nézné.

Írja be az alkalmak számát és a várakozási költségkeretet tiszta függvényként

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

Ez a kód csak az újrapróbálkozási tervet számítja ki, valójában nem vár, és nem küld kéréseket. A rögzített egy, kettő és négy másodperc a szintetikus bemutató értékei, és nem általános szervizajánlatok.

A gyártási környezeteknek a következő szempontokat is figyelembe kell venniük:

  • A szerver által visszaadott Retry-After
  • Véletlenszerű jitter, hogy elkerülje a nagy számú feladat egyidejű folytatását
  • Teljes határidő
  • A párhuzamosságok számának korlátozása

Ha a kiszolgáló által igényelt várakozási idő meghaladja a helyi költségvetést, akkor a kérés előzetes kezdeményezése helyett le kell állítania az újrapróbálkozást.

A hibatípusok különböző műveleteknek felelnek meg

nem sikerülVálasztható műveletekalapértelmezés szerint nem szabad megtenni
átmeneti torlódáskorlátozott evakuálásMinden feladatot intenzíven újra kiadnak egy időben
A bejelentkezés vagy az engedély érvénytelenKifejezetten felszólít az újbóli engedélyezésreIsmételje meg a régi hitelesítő adatokat
Számla- vagy számlarendellenességállj meg és jelentsAutomatikusan feltöltheti vagy módosíthatja a fiókokat
Bemeneti szerkezeti hibaHagyja, hogy a felhasználó javítsa a bemenetetPontosan ugyanazt a fájlt küldje el újra

Mentse el a logikai feladatokat és a kísérleti rekordokat

Egy felhasználói művelet egy logikai feladatnak felel meg, és több próbálkozás is történhet e logikai feladat alatt. A kezdési időpont, a hiba kategóriája és a távoli feladat azonosítója minden egyes próbálkozásnál naplózásra kerül. Végül csak egy elfogadott eredmény kerül kiválasztásra.

Ennek az az előnye, hogy az újrapróbálkozási problémák hibaelhárításakor teljes a rekord, ugyanakkor a próbálkozások száma nem kerül bele a felhasználói kérések számába.

📊 Alapvető összehasonlítás

koncepcióMit kell rögzítenihatás
Logikai feladatokegy felhasználói műveletUgyanannak a kérésnek felel meg, amelyet a felhasználó lát
próbálja meg felvenniKezdési idő, hibakategória, távoli feladatazonosítóAz újrapróbálkozási folyamat hibaelhárítására szolgál
Elfogadási eredményekEgy kimenet, amelyet elfogadtakA végső szállítás eredményeként

A fordítási élmény stabilitása az egyértelmű magyarázatokból adódik

Amikor csatlakozik a OmniDoc-hoz, a kezelőfelületnek egyértelműen közölnie kell a felhasználóval az aktuális állapotot: várakozik-e, újra kell-e engedélyezni, vagy ellenőriznie kell a fiókot. Ne jelenítsen meg mindent „Épület"néven.

A felhasználók készek várni a feladatra állapottal és kilépéssel, de nem hajlandók ismételten kattintani egy gombra visszajelzés nélkül.

Források: Python enum.

🎯 Melyik módszer illik hozzád?

Ha a szolgáltatás helyreállítására vár

Használjon korlátos visszalépést, állítsa be az alkalmak maximális számát és a teljes várakozási időt, és tartsa be a kiszolgálóRetry-After-jét.

Ha engedéllyel vagy fiókkal kapcsolatos problémái vannak

Állítsa le az automatikus újrapróbálkozásokat, és kérje meg a felhasználót, hogy engedélyezze újra vagy ellenőrizze a fiók állapotát.

Ha rossz a bemeneti fájl szerkezete

Hagyja, hogy a felhasználó kijavítsa a fájlt, mielőtt elküldi. Ne küldje el újra ugyanazt a fájlt.

Ha a hívott felület POST, és időtúllépés léphet fel

Először ellenőrizze, hogy az interfész támogatja-e az idempotens kulcsokat vagy a feladatlekérdezéseket, majd döntse el, hogy kívánja-e újraküldeni.

❓ Gyakran Ismételt Kérdések (GYIK)

1. Minden bejelentett hiba közvetlenül újrapróbálható?

Nem lehet. Külön kell kezelni az engedélyezési hibákat, a számlahátralékot, a sérült fájlokat és az ideiglenes foglalt szolgáltatásokat. Csak az átmeneti hibák alkalmasak korlátozott visszalépésre.

2. Elküldhető-e a POST közvetlenül az időtúllépés után?

Közvetlen újraküldés nem javasolt. Ha az ügyfél nem kap választ, az nem jelenti azt, hogy a szerver nem hozott létre feladatot. Ha nincs idempotens kulcs vagy feladatlekérdezési mechanizmus, akkor ismétlődő feladatok fordulhatnak elő.

3. Hogyan kell meghatározni az újrapróbálkozások számát és a várakozási időt?

A rögzített egy, kettő és négy másodperc csak szintetikus bemutató. A gyártási környezeteket a Retry-After, a véletlenszerű jitter, az általános határidők és az egyidejűségi korlátok kombinációjával kell meghatározni.

4. Befolyásolja-e a próbálkozások száma a felhasználói kérések statisztikáit?

Nem, csak rögzítsen egy felhasználói műveletet logikai feladatként, és rögzítsen minden újrapróbálkozást kísérleti rekordként a feladat alatt.

📝 Összefoglaló

Az újrapróbálkozás kulcsa nem az, hogy többször próbálkozz, hanem először meg kell különböztetni a hiba típusát, majd eldönteni, mit kell tenni. A helyrehozható hibákat korlátozottan próbálják újra, az emberi kezelést igénylő problémákat pedig időben visszaküldik a felhasználóknak.

Próbálja ki most: Töltse fel a dokumentumot a fordítás megkezdéséhez, megtartva az eredeti elrendezést

Frissítve: 2026-11-17