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 helyzeted | Ajánlott gyakorlatok | ok |
|---|---|---|
| Szolgáltatás átmeneti torlódása | Korlá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énytelen | Kérje meg a felhasználót az újbóli engedélyezésre | A 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 jelents | Nem szabad automatikus feltöltést vagy fiókmódosítást végrehajtani |
| Bemeneti szerkezeti hiba | Hagyja, hogy a felhasználó javítsa a bemenetet | Nincs értelme pontosan ugyanazt a fájlt újraküldeni |
| POST kérés időtúllépése | Elő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ül | Választható műveletek | alapértelmezés szerint nem szabad megtenni |
|---|---|---|
| átmeneti torlódás | korlátozott evakuálás | Minden feladatot intenzíven újra kiadnak egy időben |
| A bejelentkezés vagy az engedély érvénytelen | Kifejezetten felszólít az újbóli engedélyezésre | Ismételje meg a régi hitelesítő adatokat |
| Számla- vagy számlarendellenesség | állj meg és jelents | Automatikusan feltöltheti vagy módosíthatja a fiókokat |
| Bemeneti szerkezeti hiba | Hagyja, hogy a felhasználó javítsa a bemenetet | Pontosan 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íteni | hatás |
|---|---|---|
| Logikai feladatok | egy felhasználói művelet | Ugyanannak a kérésnek felel meg, amelyet a felhasználó lát |
| próbálja meg felvenni | Kezdési idő, hibakategória, távoli feladatazonosító | Az újrapróbálkozási folyamat hibaelhárítására szolgál |
| Elfogadási eredmények | Egy kimenet, amelyet elfogadtak | A 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.


