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 situacijaPreporučene prakserazlog
Privremeni zastoj uslugeOgraničeno odlaganje, ograničen broj puta i ukupno vrijeme čekanjaIzbjegavajte intenzivno ponovno izdavanje svih zadataka u isto vrijeme
Prijava ili dopuštenje nisu valjaniZatraži od korisnika ponovnu autorizacijuPonovno korištenje starih vjerodajnica iznova i iznova samo će biti neuspješno
Nenormalan račun ili računzaustaviti se i prijavitiNe bi trebalo biti automatskih dopuna ili promjena računa
Pogreška strukture unosaNeka korisnik popravi unosNema smisla ponovno slati potpuno istu datoteku
POST zahtjev je istekaoPrvo 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-After vrać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

uspjetiNeobavezne radnjeTo se ne bi smjelo raditi prema zadanim postavkama
Privremena zagušenjaGranice se moraju povući i izbjegavatiSvi zadaci se istovremeno intenzivno ponovno izdaju
Prijava ili dozvola isteklaIzričito traži ponovnu autorizacijuPonavljajte stare vjerodajnice
Anomalije računa ili naplateZaustavite se i prijaviteAutomatsko dopunjavanje ili promjena računa
Pogreška ulazne struktureDopustite korisnicima da poprave unosPonovno 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

KonceptZabilježite štoFunkcija
Logički zadatakAkcija jednog korisnikaOdgovara istom zahtjevu koji korisnik vidi
Pokušaj snimanjaVrijeme početka, kategorija neuspjeha, ID udaljenog zadatkaKoristi se za otklanjanje poteškoća u procesu ponovnog pokušaja
Rezultati prihvaćanjaPrihvaćen izlazKao 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

Ažurirano 2026-11-17