Σφάλματα Salesforce Workbench: Αντιμετώπιση προβλημάτων εργαλείων API κατά τη διάρκεια του χρόνου διακοπής λειτουργίας

Σφάλματα Salesforce Workbench κατά τη διάρκεια του χρόνου διακοπής λειτουργίας: ξεκινήστε διαχωρίζοντας την αποτυχία του εργαλείου από την αποτυχία της πλατφόρμας

Όταν το Salesforce Workbench σταματήσει ξαφνικά να συνδέεται, το REST Explorer επιστρέφει ένα σφάλμα ή ένα ερώτημα που λειτούργησε πριν από λίγα λεπτά αρχίζει να λήγει, η ταχύτερη διαδρομή είναι να μην κάνετε κλικ στην επιλογή Επανάληψη. Αρχικά, προσδιορίστε ποιο επίπεδο αποτυγχάνει: η εφαρμογή web Workbench, το πρόγραμμα περιήγησης ή το δίκτυό σας, ο έλεγχος ταυτότητας Salesforce, η συγκεκριμένη παρουσία Salesforce ή το ίδιο το αίτημα API.

Αυτή η διάκριση έχει σημασία επειδή το Workbench είναι ένα βοηθητικό πρόγραμμα API που βασίζεται στον ιστό και συντηρείται από την κοινότητα και όχι ένα πλήρως υποστηριζόμενο προϊόν Salesforce. Το Salesforce δηλώνει ρητά ότι δεν συντηρεί το Workbench και συνιστά υποστηριζόμενες εναλλακτικές λύσεις όπως το Salesforce CLI, το Code Builder και τις Επεκτάσεις Salesforce για τον Κώδικα του Visual Studio. Το ίδιο το έργο Workbench περιγράφει επίσης το εργαλείο ως εργαλείο μόνο για συντήρηση. Ανατρέξτε στις οδηγίες αντικατάστασης του Workbench της Salesforce και στο αρχικό αποθετήριο πηγαίου κώδικα του Workbench .

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

Λίστα ελέγχου γρήγορης διαλογής (quick trialing list)

1. Ελέγξτε το Salesforce Trust πριν αλλάξετε τη διαμόρφωσή σας

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

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

2. Διατηρήστε το ακριβές σφάλμα του Workbench και ταξινομήστε το

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

Αποτυχία σύνδεσης, χρονικό όριο ή HTTP 5xx

Ένα χρονικό όριο, μια απόκριση 502, 503 ή άλλη απόκριση 5xx μπορεί να είναι συνεπής με υποβάθμιση υπηρεσίας, υπερφορτωμένη υποδομή ή ενδιάμεση βλάβη δικτύου. Μην υποθέτετε ότι ένα 5xx αποδεικνύει μια διακοπή λειτουργίας σε ολόκληρο το Salesforce. Συγκρίνετε το ίδιο ελαφρύ αίτημα από έναν άλλο εγκεκριμένο πελάτη και ελέγξτε την αξιοπιστία. Εάν πολλά προγράμματα-πελάτες αποτύχουν στην ίδια παρουσία Salesforce ταυτόχρονα, τα στοιχεία δείχνουν ότι δεν υπάρχει μόνο στο Workbench.

Σφάλματα 401 ή μη έγκυρης περιόδου σύνδεσης

Αυτά γενικά υποδεικνύουν προβλήματα ελέγχου ταυτότητας ή περιόδου λειτουργίας. Επαναλάβετε τον έλεγχο ταυτότητας με OAuth αντί να αντιγράφετε παλιά αναγνωριστικά περιόδου λειτουργίας μεταξύ προγραμμάτων περιήγησης. Εάν η κανονική σύνδεση στο Salesforce αποτύχει επίσης και το Trust αναφέρει αντίκτυπο στη σύνδεση, περιμένετε την αποκατάσταση της υπηρεσίας πριν από την εναλλαγή των διαπιστευτηρίων. Εάν η σύνδεση στο Salesforce λειτουργεί αλλά το Workbench OAuth όχι, ερευνήστε τη διαδρομή της συνδεδεμένης εφαρμογής Workbench ή χρησιμοποιήστε ένα υποστηριζόμενο εναλλακτικό πρόγραμμα-πελάτη.

403 και σφάλματα εξουσιοδότησης

Ένα σφάλμα 403 συνήθως σημαίνει ότι το αίτημα έφτασε σε μια υπηρεσία που το απέρριψε. Ελέγξτε τα δικαιώματα χρήστη, την πολιτική συνδεδεμένων εφαρμογών, τους περιορισμούς IP και τον ακριβή κωδικό σφάλματος Salesforce. Ένα γνωστό παράδειγμα ειδικά για το Workbench είναι το , το οποίο μπορεί να προκύψει όταν ένας διαχειριστής αποκλείει την συνδεδεμένη εφαρμογή Workbench. Οι οδηγίες για τις συνδεδεμένες εφαρμογέςOAUTH_APP_BLOCKED του έργου Workbench περιγράφουν αυτό το σενάριο.

3. Μειώστε τη δοκιμή στο μικρότερο ασφαλές αίτημα API

Κατά τη διάρκεια μιας ύποπτης διακοπής λειτουργίας, μην κάνετε διάγνωση με μαζική φόρτωση, ανάπτυξη μεταδεδομένων, μεγάλο ερώτημα SOQL ή σενάριο πολλαπλών βημάτων. Ξεκινήστε με ένα τελικό σημείο μόνο για ανάγνωση που είναι φθηνό στην εκτέλεση. Στον REST Explorer, ένα αίτημα όπως GET /services/data/ελέγχει την προσβασιμότητα του βασικού API. Ένα αίτημα όπως GET /services/data/v66.0/limitsμπορεί να σας βοηθήσει να ελέγξετε τα όρια του οργανισμού όταν το API λειτουργεί.

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

4. Αντιμετωπίστε τα σφάλματα ορίου API διαφορετικά από τον χρόνο διακοπής λειτουργίας

REQUEST_LIMIT_EXCEEDEDδεν είναι το ίδιο πράγμα με μια διακοπή λειτουργίας της πλατφόρμας. Το Salesforce εφαρμόζει κατανομές αιτημάτων API και όταν ένας οργανισμός υπερβαίνει το κυλιόμενο όριο χρήσης του, οι περαιτέρω κλήσεις API μπορούν να αποκλειστούν μέχρι η χρήση να πέσει κάτω από το όριο. Το άρθρο υποστήριξης του Salesforce του Ιουλίου 2026 επιβεβαιώνει ότι οι κλήσεις REST API, SOAP API, Bulk API και Bulk API 2.0 συμβάλλουν όλες στην κατανάλωση API. Ανατρέξτε στις οδηγίες του Salesforce για το REQUEST_LIMIT_EXCEEDED και την επεξήγηση του ορίου κυλιόμενου API .

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

5. Ελέγξτε για αναντιστοιχία έκδοσης API

UNSUPPORTED_API_VERSIONΑξίζει το δικό του παράρτημα. Το Salesforce δημοσίευσε ένα άρθρο υποστήριξης τον Μάιο του 2026 που εξηγούσε ότι το Workbench μπορεί να χρησιμοποιήσει από προεπιλογή μια νεότερη έκδοση API πριν το υποστηρίξει ένας οργανισμός παραγωγής ή έκδοσης προγραμματιστή. Η συνιστώμενη επιδιόρθωση του Workbench είναι να μειώσετε την προεπιλεγμένη έκδοση API σε μια που υποστηρίζεται από τον οργανισμό-στόχο. Ανατρέξτε στο άρθρο αντιμετώπισης προβλημάτων UNSUPPORTED_API_VERSION του Salesforce .

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

6. Συγκρίνετε το Workbench με έναν υποστηριζόμενο πελάτη

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

7. Χρησιμοποιήστε την πειθαρχία της επανάληψης αντί για τις καταιγίδες επανάληψης

Κατά τη διάρκεια μιας επιβεβαιωμένης διακοπής υπηρεσίας, οι επιθετικές μη αυτόματες επαναλήψεις σπάνια βοηθούν. Για αυτοματοποιημένους υπολογιστές-πελάτες, χρησιμοποιήστε περιορισμένες επαναλήψεις με εκθετική υποχώρηση και jitter όπου το επιτρέπει ο σχεδιασμός ενοποίησης. Για μη αυτόματη χρήση του Workbench, περιμένετε μια ουσιαστική ενημέρωση κατάστασης ή ένα εύλογο χρονικό διάστημα πριν επαναλάβετε το ίδιο αίτημα.

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

Συνήθη συμπτώματα και επόμενες ενέργειες

Τι αποδεικτικά στοιχεία πρέπει να συλλέξετε για ένα εισιτήριο συμβάντος;

• Χρονική σήμανση UTC και η τοπική σας ζώνη ώρας.
• Αναγνωριστικά οργανισμού και στιγμιότυπων Salesforce που είναι ασφαλή για εσωτερική κοινοποίηση.
• Το ακριβές τελικό σημείο και η μέθοδος HTTP, χωρίς ευαίσθητες παραμέτρους.
• Κατάσταση HTTP, Salesforce errorCodeκαι ένα σύντομο απόσπασμα απόκρισης.
• Εάν λειτούργησε η κανονική σύνδεση στο Salesforce.
• Εάν το ίδιο ελάχιστο αίτημα απέτυχε από έναν δεύτερο εγκεκριμένο πελάτη.
• Σχετικό αναγνωριστικό περιστατικού Salesforce Trust ή σημείωση ότι δεν ήταν ορατό κανένα αντίστοιχο περιστατικό.
• Εάν η λειτουργία ήταν μόνο για ανάγνωση ή θα μπορούσε να έχει πραγματοποιήσει μια εγγραφή.

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

Πότε πρέπει να σταματήσετε την αντιμετώπιση προβλημάτων με τα εργαλεία Workbench και switch

Αλλάξτε από το Workbench όταν η αποτυχία είναι σαφώς απομονωμένη στο Workbench, όταν η λειτουργία είναι πολύ μεγάλη για ένα βοηθητικό πρόγραμμα που βασίζεται σε πρόγραμμα περιήγησης, όταν χρειάζεστε επαναλήψιμη συμπεριφορά σεναρίου ή όταν χρειάζεστε μια υποστηριζόμενη ροή εργασίας ανάπτυξης. Οι οδηγίες αντικατάστασης της Salesforce κατευθύνουν συγκεκριμένα τους προγραμματιστές προς το Code Builder, το Salesforce CLI και τις Επεκτάσεις Salesforce για VS Code.

Μην αλλάζετε εργαλεία απλώς και μόνο για να επιβραδύνετε συνεχώς μια μη διαθέσιμη υπηρεσία Salesforce. Ένας διαφορετικός πελάτης δεν μπορεί να διορθώσει μια διακοπή λειτουργίας από την πλευρά του διακομιστή και οι επαναλαμβανόμενες κλήσεις μπορούν να κάνουν τη διάγνωση πιο θορυβώδη. Κατά τη διάρκεια του χρόνου διακοπής λειτουργίας, το καλύτερο αποτέλεσμα είναι μια σαφής ταξινόμηση: επιβεβαιωμένο περιστατικό πλατφόρμας, σφάλμα μόνο στο Workbench, πρόβλημα τοπικού δικτύου/προγράμματος περιήγησης, αναντιστοιχία έκδοσης API, πρόβλημα δικαιωμάτων/έλεγχου ταυτότητας, εξάντληση ορίου API ή σφάλμα συγκεκριμένου αιτήματος.

Συμπέρασμα

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