Главная
» Технология
»
Ошибки Salesforce Workbench: устранение неполадок API-инструментов во время простоя системы.
Ошибки Salesforce Workbench: устранение неполадок API-инструментов во время простоя системы.
Подтверждено 16 сентября 2026 г. Ошибки Workbench легко неправильно интерпретировать во время инцидента Salesforce. Неудачный вход в систему может быть вызван истекшей сессией, неправильной средой, неработающим маршрутом Workbench или сбоем API Salesforce. Запрос, возвращающий 503 Service Unavailableзначение, указывает в другом направлении, чем 401 Invalid Session, хотя оба могут появиться, когда разработчик пытается работать быстро.
Цель устранения неполадок не в том, чтобы насильно отправить один запрос. Она заключается в определении того, какой уровень неисправен, защите данных в нестабильной системе и понимании того, когда доказательства достаточно убедительны, чтобы подождать, сменить инструмент или обратиться в соответствующую службу поддержки.
Быстрая диагностика: на что, скорее всего, указывает ошибка?
То, что вы видите
Наиболее вероятный слой
Лучший следующий шаг
Страница "Рабочее место" не загрузится.
Сайт Workbench, браузер, DNS или сетевой путь
Откройте раздел «Статус доверия Salesforce» и протестируйте сайт из разрешенной альтернативной сети.
Рабочая среда загружается, но вход в систему завершается ошибкой 401.
Сессия, OAuth, имя пользователя, пароль или процесс входа в систему.
Создайте новый авторизованный логин и подтвердите выбранную среду.
API-запрос возвращает ошибку 403.
Разрешения, политика подключенных приложений или ограничение API
Проверьте ограничения для пользователя, подключенного приложения и запроса; не рассматривайте это как доказательство простоя.
Некоторые вызовы API возвращают коды 500, 502 или 503.
Платформа Salesforce, маршрутизация на границе сети, техническое обслуживание или перегрузка
Сравните время возникновения ошибки со статусом вашего экземпляра и продукта в системе доверия.
Ошибка возникает только при выполнении одного запроса или обработке одного объекта.
Синтаксис запроса, доступ к объектам, совместное использование записей или проблема с данными.
Сведите запрос к безобидному, заведомо корректному тексту и изучите тело ответа.
Эта таблица — отправная точка, а не диагноз. Один и тот же HTTP-код может иметь разные причины в зависимости от конечной точки, метода аутентификации и политики организации.
Во-первых, разберитесь в рамках поддержки Workbench.
Workbench — это браузерный пакет для взаимодействия с организациями Salesforce через несколько API, включая REST, SOAP, Bulk, Streaming, Metadata и инструменты, связанные с Apex. Однако на сайте Workbench указано, что это не официальный продукт Salesforce и что поддержка самого Workbench со стороны Salesforce недоступна. На странице «О программе» также содержится предупреждение о том, что не следует использовать приложение с производственными данными.
Это предупреждение меняет порядок действий во время простоя. Служба поддержки Salesforce может расследовать проблемы с сервисами, экземплярами или API Salesforce, но она может не устранять неполадки во всех аспектах работы интерфейса Workbench. И наоборот, проблема, о которой сообщает только Workbench, может относиться к Workbench или к пути в браузере, а не к платформе Salesforce.
По возможности оставляйте раздел устранения неполадок доступным только для чтения. Не вставляйте пароли, секреты OAuth, идентификаторы сессий, токены доступа, записи клиентов или неотредактированные заголовки запросов в скриншоты, сообщения чата или публичные отчеты о проблемах.
Для начала определите путь входа в Workbench и выбранную среду. Показанный интерфейс является иллюстративным макетом, а не экраном входа в систему в реальном времени или запросом на ввод учетных данных для изображения в статье.
Шаг 1: Перед изменением настроек Workbench проверьте статус доверия Salesforce.
Откройте раздел «Статус доверия Salesforce» в отдельной вкладке. В справочной документации Salesforce пользователям рекомендуется переходить на эту страницу в случае сбоев в работе продуктов и ухудшения качества обслуживания, а на сайте Trust можно найти информацию как о самих продуктах, так и о конкретных случаях.
Сравните два варианта:
Общий обзор продукта: отслеживайте инциденты, ухудшение качества обслуживания, сбои или события, связанные с техническим обслуживанием, которые затрагивают используемый вами сервис Salesforce.
Просмотр вашего экземпляра: найдите свой экземпляр или раздел «Мой домен» и откройте соответствующий результат.
Статус « Доступен» не гарантирует корректную работу всех операций API. Это означает, что экземпляр и его сервисы доступны в соответствии с определением статуса Salesforce. Статус «Снижение производительности» указывает на возможность работы с задержкой или частичной функциональностью; статус «Сбой в работе сервиса» означает недоступность экземпляра; статус «Техническое обслуживание» указывает на событие технического обслуживания, которое может повлиять на доступ, а может и не повлиять.
Шаг 1 — Сравните общую информацию о статусе доверия с данными экземпляра затронутой организации. Показанный экран является иллюстративным руководством по документированному алгоритму поиска, а не свидетельством действующего инцидента.
Шаг 2: Перед повторной попыткой подтвердите среду и организацию.
Workbench может подключаться к различным средам Salesforce. Прежде чем сделать вывод о недоступности API, убедитесь, что сбойный запрос направлен в производственную среду, тестовую среду или другую авторизованную среду. Тест, успешно прошедший в одной среде, не устраняет проблему в той среде, где фактически произошел сбой.
Используйте идентификатор My Domain или идентификатор экземпляра для затронутой организации. В документации Salesforce указано, что префикс My Domain можно использовать в статусе доверия, а администратор может найти экземпляр в разделе «Настройка» в подразделе « Информация о компании» . Запишите номер экземпляра, среду, версию API, приблизительное время сбоя и конечную точку. Эта небольшая запись предотвратит распространенную ошибку: сравнение ошибки в рабочей среде со статусом работоспособной песочницы.
Если на странице входа в Workbench отображается неподдерживаемый метод входа или происходит возврат к экрану входа, рассматривайте это как отдельную проблему аутентификации или Workbench, пока статус доверия и прямой вход в Salesforce не покажут обратное. Не следует повторно вводить учетные данные во время предполагаемого сбоя; чрезмерное количество повторных попыток может привести к блокировкам или создать лишнюю информацию для расследования.
Шаг 3: Классифицируйте ответ API вместо того, чтобы гадать.
В документации Salesforce по REST API поясняется, что заголовок ответа содержит код состояния HTTP, а тело ответа обычно содержит сообщение и, если это применимо, поле или объект, связанный с ошибкой. Сохраните оба этих элемента.
Код
Подсказка, задокументированная компанией Salesforce.
Как это интерпретировать во время простоя
400
Запрос не удавалось понять, часто из-за некорректного содержимого в формате JSON или XML.
Обычно сначала устраняют проблему, прежде чем рассматривать её как сбой.
401
Идентификатор сессии или токен OAuth устарели или недействительны.
Пройдите повторную аутентификацию через утвержденный процесс; код ошибки 401 сам по себе не является доказательством сбоя платформы.
403
Запрос был отклонен, часто из-за ограничений прав доступа или лимита API.
Перед тем как объявлять инцидент, связанный с доступностью, проверьте права доступа и ограничения.
500
В платформе Lightning произошла ошибка.
Повторяйте попытку только после регистрации ответа; сравнивайте повторяющиеся сбои со статусом доверия.
502
Salesforce Edge не удалось установить связь с экземпляром.
Возможны проблемы с маршрутизацией или на стороне платформы, особенно при обработке множества запросов.
503
Сервер недоступен; возможно, требуется техническое обслуживание или он перегружен.
Проверьте наличие инцидентов или событий, требующих технического обслуживания, и избегайте повторных попыток, приводящих к сбоям.
Шаг 3 — Запишите HTTP-код и значение ответа перед изменением учетных данных или запросов. В примере отсутствуют токен, данные клиента или реальный идентификатор инцидента.
Шаг 4: Проведите безопасный сравнительный тест.
Как только вы определите статус и окружение, используйте минимально допустимый тест только для чтения. Хорошее сравнение должно обладать тремя свойствами: оно должно быть направлено на затронутую организацию, не должно изменять данные и должно быть достаточно простым, чтобы ошибка формата запроса была маловероятна.
Повторите ту же безобидную просьбу еще раз после того, как зафиксируете первый ответ.
Если запрос возвращает ошибку 401, следует начать новый процесс авторизованной аутентификации, а не использовать старую сессию.
Если возвращается код 400, 403 или 404, проверьте конечную точку, версию API, имя объекта, права доступа и тело запроса.
Если система неоднократно возвращает коды 500, 502 или 503, сравните время и номер экземпляра с показателем Trust Status.
Если пользовательский интерфейс в браузере работает, но Workbench не работает, проверьте тот же авторизованный путь к API с помощью утвержденного внутреннего клиента или средства диагностики интеграции.
Не используйте запросы на запись, удаление, массовое обновление, развертывание метаданных или миграцию в качестве проверки работоспособности. Во время инцидента запись может привести к получению частичных результатов, дублированию работы или ложному впечатлению о завершении восстановления.
Когда следует изменить подход к устранению неполадок?
Измените подход, если в статусе доверия отображается инцидент.
Прекратите перепроектирование запроса, если у вас нет независимых доказательств того, что запрос имеет неправильный формат. Сохраните номер инцидента, затронутую службу, экземпляр, время начала и последнее обновление. Следуйте инструкциям Salesforce по восстановлению и защитите задачи в очереди от повторных попыток.
Измените подход, если статус доверия доступен, но использование только Workbench не помогает.
Сосредоточьтесь на Workbench, браузере, сети, аутентификации или локальной политике. Попробуйте открыть окно браузера в режиме приватного просмотра, использовать поддерживаемый альтернативный браузер и сравнить разрешенные сети. Сайт Workbench направляет запросы на поддержку Workbench к ресурсам сообщества открытого исходного кода, в то время как справка Salesforce остается каналом для получения поддержки по продуктам и учетным записям Salesforce.
Измените подход, если ошибка постоянно отображается как 401 или 403.
Перейдите к анализу идентификации и авторизации. Подтвердите пользователя, политику подключенного приложения, область действия OAuth, срок действия сессии, доступ к API, профиль или набор разрешений, а также ограничения организации. Многократное обновление браузера не исправит отсутствующее разрешение или недействительный токен.
Меняйте подход, если один из конечных пунктов не работает, но простые операции чтения выполняются.
Изучите конечную точку, объект, поле, совместное использование записей, версию API, тело запроса и тело ответа. Узкой проблемы недостаточно, чтобы объявить Salesforce неработоспособной в глобальном масштабе. Сократите запрос, пока не сможете определить, связана ли проблема с синтаксисом, доступом, данными или зависимой службой.
Шаг 4 — Соблюдайте ограничения поддержки и безопасности Workbench. Используйте утвержденную службу поддержки Salesforce для решения инцидентов на платформе и ресурсы сообщества с открытым исходным кодом для решения проблем, связанных со специфическими особенностями Workbench.
Какие подтверждающие документы следует отправить в службу поддержки?
Страница рабочей среды или операция API, задействованная
HTTP-код, код ошибки и отредактированное тело ответа.
Сбой происходит независимо от того, затронул ли его пользовательский интерфейс Salesforce, другого пользователя или другого утвержденного клиента.
Номер инцидента, связанного со статусом доверия, или примечание о том, что соответствующее событие не было обнаружено.
Перед отправкой журналов удалите учетные данные, идентификаторы сессий, токены доступа, имена клиентов, идентификаторы записей и конфиденциальную информацию. Если проблема касается только Workbench, воспользуйтесь ссылкой на страницу справки Workbench ; Salesforce не предоставляет поддержку самого продукта Workbench.
Как проверить восстановление
Зеленый индикатор состояния обнадеживает, но это еще не финишная прямая. Проверяйте восстановление послойно:
Убедитесь, что на странице инцидента отображается решение или что статус экземпляра снова стал «Доступен».
Войдите в систему, используя утвержденный процесс Salesforce или Workbench, без повторного использования устаревшей сессии.
Выполните тот же безобидный запрос только для чтения, который ранее завершился неудачей.
Сравните HTTP-код, время ответа и тело ответа с зарегистрированной ошибкой.
Проверьте интеграции, задачи в очереди и последующие уведомления на предмет задержек или дублирования работы.
Вам нужен не просто «открыта страница». Вам необходимо, чтобы исходная авторизованная операция прошла успешно, с ожидаемым ответом и без каких-либо непроверенных побочных эффектов.
Контрольный список для самопроверки
Область проверки: Вы проверили как страницу доверия на уровне продукта, так и затронутый экземпляр?
Окружение: Вы подтвердили совместимость с производственной и тестовой средой, а также правильность выбранного домена My Domain или экземпляра?
Доказательства: Сохранили ли вы точный HTTP-код, код ошибки, время и отредактированный ответ?
Безопасность: Удалось ли вам избежать запросов на запись, удаление, пакетную обработку, развертывание и миграцию во время инцидента?
Решение: Вы различали поведение, характерное только для Workbench, и сбой API Salesforce?
Восстановление: Вы повторно проверили исходную работу и осмотрели отложенные последующие этапы?
Итог
При возникновении ошибок Salesforce Workbench во время простоя начните с проверки статуса доверия и затронутого экземпляра, затем классифицируйте HTTP-ответ, прежде чем изменять учетные данные или перезаписывать запросы. Повторяющиеся ошибки 500, 502 или 503 в простых тестах только для чтения и соответствующем инциденте доверия указывают на проблему на стороне Salesforce. Ошибки 401, 403, 400 или сбой только в Workbench обычно требуют проверки аутентификации, разрешений, запроса, браузера или Workbench. Поскольку Workbench не является продуктом, поддерживаемым Salesforce, не используйте в нем данные из производственной среды, четко задокументируйте границы и используйте последние официальные данные о статусе и рекомендации службы поддержки при изменении ситуации.