Dacă interfața raportează o eroare, încercați din nou? Sarcinile de documentare ar trebui mai întâi să distingă ce erori pot fi recuperate

Este foarte frecvent să încerci din nou după raportarea unei erori. Încercarea din nou la infinit după raportarea unei erori va amplifica erori minore. Erorile de permisiune, delincvența contului, fișierele corupte și serviciile temporar ocupate nu ar trebui să urmeze aceeași cale de reîncercare. După clasificare, decideți cât timp să așteptați, de câte ori să încercați cel mult și dacă este necesară intervenția utilizatorului.

Reîncercarea după ce este raportată o eroare este o practică obișnuită, dar dacă reîncercați la nesfârșit fără discriminare, erorile pot fi amplificate. Erorile de permisiune, delincvența contului, fișierele deteriorate și serviciile temporar ocupate trebuie tratate diferit.

Acest articol este potrivit pentru dezvoltatorii și studenții de produse care efectuează sarcini asincrone, cum ar fi traducerea și conversia documentelor. După ce ați citit acest lucru, puteți mai întâi să clasificați eșecurile și apoi să decideți cât timp să așteptați, câte încercări cel mult și când este necesară intervenția utilizatorului.

Codul și fluxul de mai jos se bazează pe mostre sintetice care au fost testate într-un mediu izolat. Ele nu reprezintă o garanție a tuturor documentelor autentice sau a efectelor produsului. Vă rugăm să păstrați originalele înainte de a procesa documentele importante și să le revizuiți în funcție de limitele și elementele de acceptare din text.

Cum să reîncercați după ce sarcina de document raportează o eroare? O singură propoziție concluzie

Mai întâi, clasificați eșecul înainte de a decide dacă să încercați din nou: eșecurile temporare sunt limitate și retrase, problemele de permisiuni și de cont sunt oprite și predate utilizatorului, iar erorile de introducere sunt lăsate utilizatorului să le remedieze.

situatia taPractici recomandatemotiv
Aglomerație temporară a serviciuluiRetragere limitată, număr limitat de ori și timp total de așteptareEvitați reeditarea intensivă a tuturor sarcinilor în același timp
Autentificare sau permisiune invalidăSolicitați utilizatorului să reautorizezeReutilizarea vechilor acreditări din nou și din nou va continua doar să eșueze
Anormalitate contului sau facturiiopriți și raportațiNu ar trebui să existe reîncărcări automate sau modificări ale contului
Eroare structura de intrareLăsați utilizatorul să repare intrareaNu are rost să retrimitem exact același fișier
Solicitarea POST a expiratMai întâi confirmați dacă interfața acceptă chei idempotente sau interogări de activitate.Dacă clientul nu primește un răspuns, nu înseamnă că serverul nu a creat o sarcină.

Mai întâi stabiliți dacă reîncercarea va genera sarcini duplicate.

Timeout-urile POST sunt deosebit de supărătoare. Dacă clientul nu primește un răspuns, nu înseamnă că serverul nu a creat o sarcină. Dacă interfața nu are chei idempotente și nu are un mecanism de interogare a sarcinilor, retrimiterea oarbă poate crea mai multe sarcini de traducere.

Prin urmare, strategia de reîncercare ar trebui să urmeze de preferință contractul de interfață în loc să se uite doar la codul de stare HTTP.

Scrieți numărul de ori și bugetul de așteptare ca funcții pure

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

Acest cod calculează doar planul de reîncercare, nu așteaptă de fapt și nu emite solicitări. Secunda fixă, două și patru secunde sunt valorile demonstrației sintetice și nu sunt recomandări generale de serviciu.

Mediile de producție trebuie, de asemenea, să ia în considerare următoarele puncte:

  • Retry-After returnat de server
  • Jitter aleatoriu pentru a evita reluarea unui număr mare de sarcini în același timp
  • Termen general
  • Limitarea numărului de concurențe

Dacă timpul de așteptare necesar serverului depășește bugetul local, acesta ar trebui să nu mai încerce în loc să inițieze solicitarea în avans.

Tipurile de eroare corespund unor acțiuni diferite

eșueazăAcțiune opționalăNu ar trebui să se facă în mod implicit
Congestie temporarăGranițele trebuie retrase și evitateToate sarcinile sunt reeditate simultan intens
Autentificare sau permisiune expiratăSolicitare explicită pentru reautorizareRepetă în mod repetat acreditările vechi
Anomalii de cont sau facturareOpriți și raportațiReîncărcare automată sau schimbare de cont
Eroare de structură de intrarePermiteți utilizatorilor să repare intrareaRetrimite exact același fișier

Salvează sarcini logice și înregistrări de încercări

Fiecare operațiune a utilizatorului corespunde unei sarcini logice, iar această sarcină logică poate avea mai multe încercări. Fiecare încercare înregistrează ora de început, categoria de defect și ID-ul sarcinii la distanță. În final, este selectat doar un singur rezultat acceptat.

Avantajul acestei abordări este că există o înregistrare completă atunci când se depanează problemele de reîncercare, iar numărul de încercări nu este contabilizat greșit ca numărul de solicitări ale utilizatorilor.

📊 Comparație cu nucleele

ConceptÎnregistrează ceFuncție
Sarcina logicăO singură acțiune a utilizatoruluiCorespunde aceleiași cereri pe care o vede utilizatorul
Încercarea de a înregistraOra de pornire, categoria de defect, ID sarcinii la distanțăFolosit pentru a depana procesul de reîncercare
Rezultatele acceptăriiO ieșire acceptatăCa rezultat final al livrării

Stabilitatea experienței de traducere provine din explicații clare

La conectarea la OmniDoc, frontend-ul ar trebui să informeze clar utilizatorii despre starea curentă: dacă așteaptă, trebuie să reautorizeze sau trebuie să verifice contul. Nu afișați toate situațiile ca "generatoare".

Utilizatorii sunt dispuși să aștepte o sarcină specifică, de tip outlet, dar nu sunt dispuși să apese repetat un buton care nu conține feedback.

Referințe: Python enum.

🎯 Care abordare ți se potrivește?

Dacă aștepți reluarea serviciului

Folosește bounded backoff, setează numărul maxim și timpul total de așteptare și respectăRetry-After-ul serverului.

Dacă întâmpini probleme cu permisiunile sau contul

Opriți reîncercările automate, solicitați utilizatorilor să reautorizeze sau să verifice starea contului.

Dacă structura fișierelor de intrare este incorectă

Permiteți utilizatorilor să repare fișierele înainte de a trimite și nu retrimiteți același fișier.

Dacă interfața pe care o apelați este POST și poate expira

Mai întâi, confirmați dacă interfața suportă chei idempotente sau interogări de sarcini, apoi decideți dacă doriți să o retrimiteți.

❓ Întrebări frecvente (FAQ)

1. Pot fi reîncercate toate erorile direct?

Nu. Erorile de permisiuni, conturile învechite, fișierele corupte și congestia temporară a serviciului trebuie gestionate separat; doar defectele temporare sunt potrivite pentru retragerea limitată.

2. Pot să retrimit după o pauză POST?

Nu se recomandă retrimiterea directă. Dacă clientul nu primește un răspuns, asta nu înseamnă că serverul nu a creat o sarcină. Fără chei idempotente sau mecanisme de interogare a sarcinilor, pot apărea sarcini duplicate.

3. Cum ar trebui determinat numărul de încercări și timpii de așteptare?

Cele fixe de unu, două și patru secunde sunt doar demonstrații de sinteză. Mediul de producție ar trebui determinat prin combinarea Retry-After, jitter-ului aleatoriu, timpului total de limită și limitelor de concurență.

4. Va afecta numărul de încercări statisticile cererilor utilizatorilor?

Nu, doar înregistrează o acțiune a utilizatorului ca sarcină logică, iar fiecare reîncercare ca înregistrare a încercărilor sub acea sarcină.

📝 Rezumat

Cheia încercării nu este să faci mai multe încercări, ci mai întâi să identifici tipul de eșec și apoi să decizi ce să faci. Defectele recuperabile sunt limitate pentru a fi reîncercate, iar problemele care necesită intervenție umană sunt prompt returnate utilizatorilor.

Încearcă acum: Încarcă documentul pentru a începe traducerea, păstrând formatul original

Actualizat 2026-11-17