Εάν η διεπαφή αναφέρει σφάλμα, δοκιμάστε ξανά; Οι εργασίες τεκμηρίωσης πρέπει πρώτα να διακρίνουν ποιες αστοχίες μπορούν να ανακτηθούν

Είναι πολύ συνηθισμένο να προσπαθείτε ξανά μετά την αναφορά ενός σφάλματος. Προσπαθώντας ξανά άπειρα μετά την αναφορά ενός σφάλματος θα ενισχύσει τα μικρά σφάλματα. Τα σφάλματα αδειών, οι καθυστερήσεις λογαριασμών, τα κατεστραμμένα αρχεία και οι υπηρεσίες προσωρινής απασχόλησης δεν πρέπει να ακολουθούν την ίδια διαδρομή επανάληψης. Μετά την κατηγοριοποίηση, αποφασίστε πόσο καιρό θα περιμένετε, πόσες προσπάθειες το πολύ και αν απαιτείται παρέμβαση χρήστη.

Η επανάληψη μετά την αναφορά σφάλματος είναι μια συνηθισμένη πρακτική, αλλά αν προσπαθήσετε ξανά επ' αόριστον και αδιάκριτα, τα σφάλματα μπορεί να μεγεθυνθούν. Τα σφάλματα αδειών, οι καθυστερήσεις λογαριασμών, τα κατεστραμμένα αρχεία και οι προσωρινές απασχολημένες υπηρεσίες θα πρέπει να αντιμετωπίζονται διαφορετικά.

Αυτό το άρθρο είναι κατάλληλο για προγραμματιστές και φοιτητές προϊόντων που εκτελούν ασύγχρονες εργασίες, όπως η μετάφραση και η μετατροπή εγγράφων. Αφού διαβάσετε αυτό, μπορείτε πρώτα να κατηγοριοποιήσετε τις αποτυχίες και στη συνέχεια να αποφασίσετε πόσο καιρό θα περιμένετε, πόσες προσπάθειες το πολύ και πότε απαιτείται παρέμβαση του χρήστη.

Ο κώδικας και η ροή παρακάτω βασίζονται σε συνθετικά δείγματα που έχουν δοκιμαστεί σε απομονωμένο περιβάλλον. Δεν αποτελούν εγγύηση για όλα τα αυθεντικά έγγραφα ή τα αποτελέσματα του προϊόντος. Κρατήστε τα πρωτότυπα πριν επεξεργαστείτε σημαντικά έγγραφα και ελέγξτε τα σύμφωνα με τα όρια και τα στοιχεία αποδοχής στο κείμενο.

Πώς να προσπαθήσω ξανά αφού η εργασία εγγράφου αναφέρει ένα σφάλμα; Μια φράση συμπέρασμα

Αρχικά ταξινομήστε την αποτυχία πριν αποφασίσετε εάν θα προσπαθήσετε ξανά: οι προσωρινές αποτυχίες περιορίζονται και αποσύρονται, τα ζητήματα αδειών και λογαριασμού διακόπτονται και παραδίδονται στον χρήστη και τα σφάλματα εισαγωγής αφήνονται στον χρήστη να τα διορθώσει.

την κατάστασή σαςΣυνιστώμενες πρακτικέςλόγος
Προσωρινή συμφόρηση υπηρεσιώνΟριοθετημένη επιστροφή, περιορισμένος αριθμός φορών και συνολικός χρόνος αναμονήςΑποφύγετε την εντατική επανέκδοση όλων των εργασιών ταυτόχρονα
Μη έγκυρη είσοδος ή άδειαΖητήστε από τον χρήστη να εξουσιοδοτήσει εκ νέουΗ επαναχρησιμοποίηση παλαιών διαπιστευτηρίων ξανά και ξανά θα συνεχίσει να αποτυγχάνει
Ανωμαλία λογαριασμού ή λογαριασμούσταματήστε και αναφέρετεΔεν θα πρέπει να υπάρχουν αυτόματες ανανεώσεις ή αλλαγές λογαριασμού
Σφάλμα δομής εισόδουΑφήστε τον χρήστη να διορθώσει την είσοδοΔεν έχει νόημα να ξαναστείλετε το ίδιο ακριβώς αρχείο
Λήξη χρονικού ορίου αιτήματος POSTΠρώτα επιβεβαιώστε εάν η διεπαφή υποστηρίζει ανεπαρκή κλειδιά ή ερωτήματα εργασιών.Εάν ο πελάτης δεν λάβει απάντηση, δεν σημαίνει ότι ο διακομιστής δεν έχει δημιουργήσει μια εργασία.

Καθορίστε πρώτα εάν η επανάληψη θα δημιουργήσει διπλότυπες εργασίες.

Τα χρονικά όρια POST είναι ιδιαίτερα ενοχλητικά. Εάν ο πελάτης δεν λάβει απάντηση, δεν σημαίνει ότι ο διακομιστής δεν έχει δημιουργήσει μια εργασία. Εάν η διασύνδεση δεν διαθέτει κλειδιά και δεν διαθέτει μηχανισμό ερωτήματος εργασιών, η τυφλή εκ νέου αποστολή ενδέχεται να δημιουργήσει πολλαπλές εργασίες μετάφρασης.

Επομένως, η στρατηγική επανάληψης θα πρέπει πρώτα να ακολουθεί τη σύμβαση διεπαφής αντί να κοιτάζει απλώς τον κωδικό κατάστασης HTTP.

Γράψτε τον αριθμό των φορών και τον προϋπολογισμό αναμονής ως καθαρές συναρτήσεις

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

Αυτός ο κωδικός υπολογίζει μόνο το σχέδιο επανάληψης, δεν περιμένει στην πραγματικότητα και δεν εκδίδει αιτήματα. Το σταθερό ένα, δύο και τέσσερα δευτερόλεπτα είναι οι τιμές της συνθετικής επίδειξης και δεν είναι γενικές συστάσεις σέρβις.

Τα περιβάλλοντα παραγωγής πρέπει επίσης να λάβουν υπόψη τα ακόλουθα σημεία:

  • Το Retry-After επιστράφηκε από τον διακομιστή
  • Τυχαίο τρέμουλο για να αποφευχθεί η επανάληψη μεγάλου αριθμού εργασιών ταυτόχρονα
  • Συνολική προθεσμία
  • Όριο στον αριθμό των συγχρονισμών

Εάν ο χρόνος αναμονής που απαιτείται από τον διακομιστή υπερβαίνει τον τοπικό προϋπολογισμό, θα πρέπει να σταματήσει την επανάληψη αντί να εκκινήσει το αίτημα εκ των προτέρων.

Οι τύποι σφαλμάτων αντιστοιχούν σε διαφορετικές ενέργειες

αποτυγχάνωΠροαιρετική ενέργειαΔεν πρέπει να γίνεται από προεπιλογή
Προσωρινή συμφόρησηΤα όρια πρέπει να υποχωρήσουν και να αποφευχθούνΌλες οι εργασίες επανεκδίδονται ταυτόχρονα εντατικά
Η σύνδεση ή η άδεια έληξεΡητή προτροπή για επανεξουσιοδότησηΕπαναλαμβανόμενη επανάληψη παλαιών διαπιστευτηρίων
Ανωμαλίες λογαριασμού ή χρέωσηςΣταματήστε και αναφέρετεΑυτόματη ανανέωση ή αλλαγή λογαριασμού
Σφάλμα δομής εισόδουΕπιτρέψτε στους χρήστες να καθορίζουν την είσοδοΑποστολή ξανά του ίδιου ακριβώς αρχείου

Αποθήκευση λογικών εργασιών και εγγραφών προσπαθειών

Κάθε λειτουργία χρήστη αντιστοιχεί σε μια λογική εργασία, και αυτή η λογική εργασία μπορεί να έχει πολλαπλές προσπάθειες. Κάθε προσπάθεια καταγράφει την ώρα έναρξης, την κατηγορία αποτυχίας και το αναγνωριστικό απομακρυσμένης εργασίας. Τελικά, επιλέγεται μόνο ένα αποδεκτό αποτέλεσμα.

Το πλεονέκτημα αυτής της προσέγγισης είναι ότι υπάρχει πλήρες αρχείο κατά την αντιμετώπιση προβλημάτων επανάληψης, και ο αριθμός των προσπαθειών δεν υπολογίζεται λανθασμένα ως ο αριθμός των αιτημάτων χρηστών.

📊 Σύγκριση Πυρήνων

ΈννοιαΚαταγράψτε τιΛειτουργία
Λογική εργασίαΜία ενέργεια χρήστηΑντιστοιχεί στο ίδιο αίτημα που βλέπει ο χρήστης
Προσπάθεια εγγραφήςΏρα έναρξης, κατηγορία αποτυχίας, αναγνωριστικό απομακρυσμένης εργασίαςΧρησιμοποιείται για την αντιμετώπιση προβλημάτων της διαδικασίας επανάληψης
Αποτελέσματα αποδοχήςΜια αποδεκτή έξοδοςΩς τελικό αποτέλεσμα της παράδοσης

Η σταθερότητα της εμπειρίας μετάφρασης προέρχεται από σαφείς εξηγήσεις

Κατά τη σύνδεση στο OmniDoc, το frontend θα πρέπει να ενημερώνει σαφώς τους χρήστες για την τρέχουσα κατάσταση: αν περιμένουν, αν χρειάζονται επανεξουσιοδότηση ή αν πρέπει να ελέγξουν τον λογαριασμό. Μην εμφανίζετε όλες τις καταστάσεις ως «Δημιουργία».

Οι χρήστες είναι διατεθειμένοι να περιμένουν για μια δηλωμένη, διευκρινιστική εργασία, αλλά δεν είναι διατεθειμένοι να πατούν επανειλημμένα ένα κουμπί που δεν έχει καμία ανατροφοδότηση.

Αναφορές: Python enum.

🎯 Ποια προσέγγιση σου ταιριάζει;

Αν περιμένεις να ξαναρχίσει η υπηρεσία

Χρησιμοποιήστε bounded backoff, ορίστε μέγιστο αριθμό και συνολικό χρόνο αναμονής και σεβαστείτε τοRetry-After του διακομιστή.

Αν αντιμετωπίσετε προβλήματα με δικαιώματα ή λογαριασμούς

Σταματήστε τις αυτόματες επαναλήψεις, ζητήστε από τους χρήστες να επανεξουσιοδοτήσουν ή ελέγξτε την κατάσταση του λογαριασμού.

Αν η δομή του αρχείου εισόδου σας είναι λανθασμένη

Επιτρέψτε στους χρήστες να επιδιορθώνουν αρχεία πριν τα υποβάλουν και μην στέλνετε ξανά το ίδιο αρχείο.

Αν η διεπαφή που καλείς είναι POST και μπορεί να λήξει το χρονικό όριο

Πρώτα, επιβεβαιώστε αν η διεπαφή υποστηρίζει idempotent keys ή ερωτήματα εργασιών και στη συνέχεια αποφασίστε αν θα το ξαναστείλετε.

❓ Συχνές Ερωτήσεις (FAQ)

1. Μπορούν όλα τα σφάλματα να επαναληφθούν απευθείας;

Όχι. Σφάλματα δικαιωμάτων, καθυστέρηση λογαριασμού, κατεστραμμένα αρχεία και προσωρινή συμφόρηση υπηρεσίας πρέπει να αντιμετωπίζονται ξεχωριστά· μόνο προσωρινές αποτυχίες είναι κατάλληλες για περιορισμένη υποχώρηση.

2. Μπορώ να το ξαναστείλω μετά από timeout POST;

Δεν συνιστάται να ξαναστείλετε απευθείας. Αν ο πελάτης δεν λάβει απάντηση, αυτό δεν σημαίνει ότι ο διακομιστής δεν έχει δημιουργήσει μια εργασία. Χωρίς ιδεμποτένια κλειδιά ή μηχανισμούς ερωτήματος εργασίας, μπορεί να προκύψουν διπλές εργασίες.

3. Πώς πρέπει να καθορίζεται ο αριθμός των επαναλήψεων και των χρόνων αναμονής;

Τα σταθερά ένα, δύο και τέσσερα δευτερόλεπτα είναι απλώς επιδείξεις σύνθεσης. Το περιβάλλον παραγωγής θα πρέπει να καθορίζεται συνδυάζοντας το Retry-After, το τυχαίο jitter, τον συνολικό χρόνο αποκοπής και τα όρια ταυτόχρονης εκτέλεσης.

4. Θα επηρεάσει ο αριθμός των προσπαθειών τα στατιστικά των αιτημάτων χρηστών;

Όχι, απλώς καταγράψτε μία ενέργεια χρήστη ως λογική εργασία και κάθε επανάληψη ως καταγραφή των προσπαθειών κάτω από αυτήν την εργασία.

📝 Περίληψη

Το κλειδί για να ξαναδοκιμάσεις δεν είναι πολλές προσπάθειες, αλλά πρώτα να εντοπίσεις τον τύπο της αποτυχίας και μετά να αποφασίσεις τι θα κάνεις. Τα ανακτήσιμα σφάλματα είναι βέβαιο ότι θα επαναληφθούν και τα ζητήματα που απαιτούν ανθρώπινη παρέμβαση επιστρέφονται άμεσα στους χρήστες.

Δοκιμάστε το τώρα: Ανεβάστε το έγγραφό σας για να ξεκινήσετε τη μετάφραση, διατηρώντας την αρχική μορφοποίηση

Ενημερώθηκε 2026-11-17