Ako sučelje javi pogrešku, pokušati ponovno? Dokumentacijski zadaci trebaju prvo razlikovati koji se kvarovi mogu oporaviti
Vrlo je uobičajeno pokušati ponovno nakon prijave pogreške. Ponovni pokušaj u nedogled nakon prijave pogreške pojačat će manje greške. Pogreške dopuštenja, kašnjenja računa, oštećene datoteke i privremeno zauzete usluge ne bi trebale slijediti isti put ponovnog pokušaja. Nakon kategorizacije odlučite koliko dugo čekati, koliko pokušaja najviše i je li potrebna intervencija korisnika.
Ponovni pokušaj nakon prijave pogreške uobičajena je praksa, ali ako pokušavate neodređeno vrijeme bez razlike, kvarovi se mogu povećati. Pogreške dopuštenja, kašnjenja računa, oštećene datoteke i usluge koje su privremeno zauzete trebale bi se tretirati drugačije.
Ovaj je članak prikladan za programere i studente proizvoda koji rade asinkrone zadatke kao što su prijevod i konverzija dokumenata. Nakon što ovo pročitate, prvo možete kategorizirati kvarove, a zatim odlučiti koliko dugo čekati, koliko pokušaja najviše i kada je potrebna intervencija korisnika.
Kod i tok u nastavku temelje se na sintetičkim uzorcima koji su testirani u izoliranom okruženju. Oni ne predstavljaju jamstvo svih autentičnih dokumenata ili učinaka proizvoda. Molimo sačuvajte izvornike prije obrade važnih dokumenata i pregledajte ih u skladu s granicama i stavkama prihvaćanja u tekstu.
Kako pokušati ponovno nakon što zadatak dokumenta prijavi pogrešku? Zaključak jedne rečenice
Prvo klasificirajte neuspjeh prije nego što odlučite hoćete li pokušati ponovno: privremeni neuspjesi su ograničeni i povučeni, problemi s dozvolama i računom su zaustavljeni i predani korisniku, a pogreške pri unosu ostavljene su korisniku da ih popravi.
| vaša situacija | Preporučene prakse | razlog |
|---|---|---|
| Privremeni zastoj usluge | Ograničeno odlaganje, ograničen broj puta i ukupno vrijeme čekanja | Izbjegavajte intenzivno ponovno izdavanje svih zadataka u isto vrijeme |
| Prijava ili dopuštenje nisu valjani | Zatraži od korisnika ponovnu autorizaciju | Ponovno korištenje starih vjerodajnica iznova i iznova samo će biti neuspješno |
| Nenormalan račun ili račun | zaustaviti se i prijaviti | Ne bi trebalo biti automatskih dopuna ili promjena računa |
| Pogreška strukture unosa | Neka korisnik popravi unos | Nema smisla ponovno slati potpuno istu datoteku |
| POST zahtjev je istekao | Prvo provjerite podržava li sučelje idempotentne ključeve ili upite zadataka. | Ako klijent ne dobije odgovor, to ne znači da poslužitelj nije kreirao zadatak. |
Prvo odredite hoće li ponovni pokušaj generirati duplicirane zadatke.
POST timeout je posebno problematičan. Ako klijent ne dobije odgovor, to ne znači da poslužitelj nije kreirao zadatak. Ako sučelje nema idempotentne ključeve i nema mehanizam upita zadataka, ponovno slijepo slanje može stvoriti više zadataka prevođenja.
Stoga bi strategija ponovnog pokušaja prvo trebala slijediti ugovor o sučelju umjesto da samo gleda HTTP statusni kod.
Napišite broj puta i proračun čekanja kao čiste funkcije
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
Ovaj kod samo izračunava plan ponovnog pokušaja, zapravo ne čeka i ne šalje zahtjeve. Fiksne jedna, dvije i četiri sekunde su vrijednosti sintetičke demonstracije i nisu opće preporuke za uslugu.
Proizvodna okruženja također trebaju uzeti u obzir sljedeće točke:
Retry-Aftervraćen od strane poslužitelja- Nasumični jitter za izbjegavanje istovremenog vraćanja više zadataka
- Ukupni rok
- Ograničenja konkurentnosti
Ako vrijeme čekanja koje zahtijeva poslužitelj premašuje lokalni proračun, trebao bi prestati s ponovnim pokušajima umjesto da unaprijed pokrene zahtjev.
Vrste pogrešaka odgovaraju različitim radnjama
| uspjeti | Neobavezne radnje | To se ne bi smjelo raditi prema zadanim postavkama |
|---|---|---|
| Privremena zagušenja | Granice se moraju povući i izbjegavati | Svi zadaci se istovremeno intenzivno ponovno izdaju |
| Prijava ili dozvola istekla | Izričito traži ponovnu autorizaciju | Ponavljajte stare vjerodajnice |
| Anomalije računa ili naplate | Zaustavite se i prijavite | Automatsko dopunjavanje ili promjena računa |
| Pogreška ulazne strukture | Dopustite korisnicima da poprave unos | Ponovno pošaljite istu datoteku |
Spremite logičke zadatke i zapise pokušaja
Svaka korisnička operacija odgovara logičkom zadatku, a taj logički zadatak može imati više pokušaja. Svaki pokušaj bilježi vrijeme početka, kategoriju neuspjeha i ID udaljenog zadatka. Na kraju se odabire samo jedan prihvaćeni rezultat.
Prednost ovog pristupa je što postoji potpuni zapis prilikom rješavanja problema s ponovnim pokušajima, a broj pokušaja se ne računa pogrešno kao broj korisničkih zahtjeva.
📊 Usporedba jezgri
| Koncept | Zabilježite što | Funkcija |
|---|---|---|
| Logički zadatak | Akcija jednog korisnika | Odgovara istom zahtjevu koji korisnik vidi |
| Pokušaj snimanja | Vrijeme početka, kategorija neuspjeha, ID udaljenog zadatka | Koristi se za otklanjanje poteškoća u procesu ponovnog pokušaja |
| Rezultati prihvaćanja | Prihvaćen izlaz | Kao konačni rezultat isporuke |
Stabilnost iskustva prevođenja proizlazi iz jasnih objašnjenja
Prilikom povezivanja s OmniDoc-om, frontend bi trebao jasno obavijestiti korisnike o trenutnom statusu: čekaju li, trebaju li ponovno autorizirati ili provjeriti račun. Nemojte prikazivati sve situacije kao "Generiranje."
Korisnici su spremni čekati određeni zadatak za izlaz, ali nisu spremni više puta klikati gumb bez povratne informacije.
Izvori: Python enum.
🎯 Koji ti pristup najviše odgovara?
Ako čekate da se usluga nastavi
Koristite ograničeno odstupanje, postavite maksimalni broj i ukupno vrijeme čekanja te poštujteRetry-After servera.
Ako naiđete na probleme s dozvolama ili računom
Zaustavite automatska vraćanja, potaknite korisnike da ponovno autoriziraju ili provjerite status računa.
Ako je struktura vaše ulazne datoteke netočna
Dopustite korisnicima da poprave datoteke prije slanja i nemojte ponovno slati istu datoteku.
Ako je sučelje koje pozivate POST i može isteći vrijeme
Prvo potvrdite podržava li sučelje idempotentne ključeve ili upite zadataka, zatim odlučite želite li ga ponovno poslati.
❓ Često postavljana pitanja (FAQ)
1. Mogu li se sve pogreške ponoviti izravno?
Ne. Pogreške u dozvolama, kašnjenje računa, oštećene datoteke i privremeno zagušenje usluge trebaju se rješavati zasebno; samo privremeni kvarovi su prikladni za ograničeni povlačenje.
2. Mogu li ponovno poslati nakon isteka POST vremena?
Ne preporučuje se ponovno slanje izravno. Ako klijent ne primi odgovor, to ne znači da poslužitelj nije stvorio zadatak. Bez idempotentnih ključeva ili mehanizama upita zadataka mogu se pojaviti duplicirani zadaci.
3. Kako bi se trebao odrediti broj ponovnih pokušaja i vrijeme čekanja?
Fiksni jedan, dva i četiri sekunde su samo demonstracije sinteze. Produkcijsko okruženje treba odrediti kombiniranjem Retry-After-a, slučajnog jittera, ukupnog vremena graničenja i ograničenja konkurentnosti.
4. Hoće li broj pokušaja utjecati na statistiku korisničkih zahtjeva?
Ne, samo zabilježite jednu korisničku radnju kao logički zadatak, a svaki ponovni pokušaj kao zapis pokušaja unutar tog zadatka.
📝 Sažetak
Ključ ponovnog pokušaja nije višestruki pokušaj, već prvo identificirati vrstu neuspjeha, a zatim odlučiti što učiniti. Kvarovi koji se mogu popraviti sigurno će se ponovno pokušavati, a problemi koji zahtijevaju ljudsku intervenciju brzo se vraćaju korisnicima.
Isprobajte sada: Prenesite svoj dokument da biste započeli prijevod, čuvajući izvorno oblikovanje


