Ошибки 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, отображающий поля «Стандартный», «Расширенный», «OAuth», «Окружение», «Версия API», «Имя пользователя», «Пароль», «Идентификатор сессии» и «URL-адрес сервера».
Для начала определите путь входа в Workbench и выбранную среду. Показанный интерфейс является иллюстративным макетом, а не экраном входа в систему в реальном времени или запросом на ввод учетных данных для изображения в статье.

Шаг 1: Перед изменением настроек Workbench проверьте статус доверия Salesforce.

Откройте раздел «Статус доверия Salesforce» в отдельной вкладке. В справочной документации Salesforce пользователям рекомендуется переходить на эту страницу в случае сбоев в работе продуктов и ухудшения качества обслуживания, а на сайте Trust можно найти информацию как о самих продуктах, так и о конкретных случаях.

Проверьте два варианта отображения:

  1. Общий обзор продукта: отслеживайте инциденты, ухудшение качества обслуживания, сбои или события, связанные с техническим обслуживанием, которые затрагивают используемый вами сервис Salesforce.
  2. Просмотр вашего экземпляра: найдите свой экземпляр или раздел «Мой домен» и откройте соответствующий результат.

Статус « Доступен» не гарантирует корректную работу всех операций API. Это означает, что экземпляр и его сервисы доступны в соответствии с определением статуса Salesforce. Статус «Снижение производительности» указывает на возможность работы с задержкой или частичной функциональностью; статус «Сбой в работе сервиса» означает недоступность экземпляра; статус «Техническое обслуживание» указывает на событие технического обслуживания, которое может повлиять на доступ, а может и не повлиять.

Иллюстративная страница состояния доверия Salesforce с полем поиска экземпляра или домена, содержащим mycompany, и результатом «Доступный экземпляр».
Шаг 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 произошла ошибка.Повторяйте попытку только после регистрации ответа; сравнивайте повторяющиеся сбои со статусом доверия.
502Salesforce Edge не удалось установить связь с экземпляром.Возможны проблемы с маршрутизацией или на стороне платформы, особенно при обработке множества запросов.
503Сервер недоступен; возможно, требуется техническое обслуживание или он перегружен.Проверьте наличие инцидентов или событий, требующих технического обслуживания, и избегайте повторных попыток, приводящих к сбоям.
Иллюстративный скриншот запроса к API Workbench, демонстрирующий безопасный GET-запрос и строки ответа для ошибок 401 Invalid Session, 502 Salesforce Edge, 503 Service Unavailable и 500 Internal Server Error.
Шаг 3 — Запишите HTTP-код и значение ответа перед изменением учетных данных или запросов. В примере отсутствуют токен, данные клиента или реальный идентификатор инцидента.

Шаг 4: Проведите безопасный сравнительный тест.

Как только вы определите статус и окружение, используйте минимально допустимый тест только для чтения. Хорошее сравнение должно обладать тремя свойствами: оно должно быть направлено на затронутую организацию, не должно изменять данные и должно быть достаточно простым, чтобы ошибка формата запроса была маловероятна.

  1. Повторите ту же безобидную просьбу еще раз после того, как зафиксируете первый ответ.
  2. Если запрос возвращает ошибку 401, следует начать новый процесс авторизованной аутентификации, а не использовать старую сессию.
  3. Если возвращается код 400, 403 или 404, проверьте конечную точку, версию API, имя объекта, права доступа и тело запроса.
  4. Если система неоднократно возвращает коды 500, 502 или 503, сравните время и номер экземпляра с показателем Trust Status.
  5. Если пользовательский интерфейс в браузере работает, но Workbench не работает, проверьте тот же авторизованный путь к API с помощью утвержденного внутреннего клиента или средства диагностики интеграции.

Не используйте запросы на запись, удаление, массовое обновление, развертывание метаданных или миграцию в качестве проверки работоспособности. Во время инцидента запись может привести к получению частичных результатов, дублированию работы или ложному впечатлению о завершении восстановления.

Когда следует изменить подход к устранению неполадок?

Измените подход, если в статусе доверия отображается инцидент.

Прекратите перепроектирование запроса, если у вас нет независимых доказательств того, что запрос имеет неправильный формат. Сохраните номер инцидента, затронутую службу, экземпляр, время начала и последнее обновление. Следуйте инструкциям Salesforce по восстановлению и защитите задачи в очереди от повторных попыток.

Измените подход, если статус доверия доступен, но использование только Workbench не помогает.

Сосредоточьтесь на Workbench, браузере, сети, аутентификации или локальной политике. Попробуйте открыть окно браузера в режиме приватного просмотра, использовать поддерживаемый альтернативный браузер и сравнить разрешенные сети. Сайт Workbench направляет запросы на поддержку Workbench к ресурсам сообщества открытого исходного кода, в то время как справка Salesforce остается каналом для получения поддержки по продуктам и учетным записям Salesforce.

Измените подход, если ошибка постоянно отображается как 401 или 403.

Перейдите к анализу идентификации и авторизации. Подтвердите пользователя, политику подключенного приложения, область действия OAuth, срок действия сессии, доступ к API, профиль или набор разрешений, а также ограничения организации. Многократное обновление браузера не исправит отсутствующее разрешение или недействительный токен.

Меняйте подход, если один из конечных пунктов не работает, но простые операции чтения выполняются.

Изучите конечную точку, объект, поле, совместное использование записей, версию API, тело запроса и тело ответа. Узкой проблемы недостаточно, чтобы объявить Salesforce неработоспособной в глобальном масштабе. Сократите запрос, пока не сможете определить, связана ли проблема с синтаксисом, доступом, данными или зависимой службой.

Иллюстративная страница «О программе» Workbench, содержащая уведомления о том, что Workbench не является официальным продуктом Salesforce, не поддерживается Salesforce, не должен использоваться с производственными данными и имеет поддержку сообщества с открытым исходным кодом.
Шаг 4 — Соблюдайте ограничения поддержки и безопасности Workbench. Используйте утвержденную службу поддержки Salesforce для решения инцидентов на платформе и ресурсы сообщества с открытым исходным кодом для решения проблем, связанных со специфическими особенностями Workbench.

Какие подтверждающие документы следует отправить в службу поддержки?

Если проблема с Salesforce сохраняется, воспользуйтесь официальными рекомендациями службы поддержки Salesforce для соответствующего канала, доступными в рамках вашего плана поддержки. Включите:

  • Идентификатор организации, экземпляр и среда
  • Отметка времени UTC и ваш местный часовой пояс
  • Страница рабочей среды или операция API, задействованная
  • HTTP-код, код ошибки и отредактированное тело ответа.
  • Сбой происходит независимо от того, затронул ли его пользовательский интерфейс Salesforce, другого пользователя или другого утвержденного клиента.
  • Номер инцидента, связанного со статусом доверия, или примечание о том, что соответствующее событие не было обнаружено.

Перед отправкой журналов удалите учетные данные, идентификаторы сессий, токены доступа, имена клиентов, идентификаторы записей и конфиденциальную информацию. Если проблема касается только Workbench, воспользуйтесь ссылкой на страницу справки Workbench ; Salesforce не предоставляет поддержку самого продукта Workbench.

Как проверить восстановление

Зеленый индикатор состояния обнадеживает, но это еще не финишная прямая. Проверяйте восстановление послойно:

  1. Убедитесь, что на странице инцидента отображается решение или что статус экземпляра снова стал «Доступен».
  2. Войдите в систему, используя утвержденный процесс Salesforce или Workbench, без повторного использования устаревшей сессии.
  3. Выполните тот же безобидный запрос только для чтения, который ранее завершился неудачей.
  4. Сравните HTTP-код, время ответа и тело ответа с зарегистрированной ошибкой.
  5. Проверьте интеграции, задачи в очереди и последующие уведомления на предмет задержек или дублирования работы.

Вам нужен не просто «открыта страница». Вам необходимо, чтобы исходная авторизованная операция прошла успешно, с ожидаемым ответом и без каких-либо непроверенных побочных эффектов.

Контрольный список для самопроверки

  • Область проверки: Вы проверили как страницу доверия на уровне продукта, так и затронутый экземпляр?
  • Окружение: Вы подтвердили совместимость с производственной и тестовой средой, а также правильность выбранного домена My Domain или экземпляра?
  • Доказательства: Сохранили ли вы точный HTTP-код, код ошибки, время и отредактированный ответ?
  • Безопасность: Удалось ли вам избежать запросов на запись, удаление, пакетную обработку, развертывание и миграцию во время инцидента?
  • Решение: Вы различали поведение, характерное только для Workbench, и сбой API Salesforce?
  • Восстановление: Вы повторно проверили исходную работу и осмотрели отложенные последующие этапы?

Итог

При возникновении ошибок Salesforce Workbench во время простоя начните с проверки статуса доверия и затронутого экземпляра, затем классифицируйте HTTP-ответ, прежде чем изменять учетные данные или перезаписывать запросы. Повторяющиеся ошибки 500, 502 или 503 в простых тестах только для чтения и соответствующем инциденте доверия указывают на проблему на стороне Salesforce. Ошибки 401, 403, 400 или сбой только в Workbench обычно требуют проверки аутентификации, разрешений, запроса, браузера или Workbench. Поскольку Workbench не является продуктом, поддерживаемым Salesforce, не используйте в нем данные из производственной среды, четко задокументируйте границы и используйте последние официальные данные о статусе и рекомендации службы поддержки при изменении ситуации.

Официальные источники

Оставить комментарий

Collabora Online против ONLYOFFICE: измерение объема оперативной памяти и задержки редактирования.

Сравните Collabora Online и ONLYOFFICE Docs на одном сервере с помощью воспроизводимого теста, измеряющего использование памяти, время открытия документа и задержку при совместном редактировании.

OnlyOffice Docs против Microsoft 365 Web: какой из них постоянно форматирует документ?

Сравните поведение документов, электронных таблиц и макетов в ONLYOFFICE Docs и веб-приложениях Microsoft 365, а затем с помощью быстрого теста выберите более безопасный редактор для ваших файлов.

Почему формулы в электронных таблицах различаются между ONLYOFFICE и Excel?

Почему формулы в электронных таблицах различаются между ONLYOFFICE и Excel?

Выявление несоответствий в формулах может быть связано с синтаксисом, региональными разделителями, пересчетом, системами дат или неподдерживаемыми функциями, после чего необходимо проверить рабочую книгу перед ее предоставлением.

OnlyOffice против LibreOffice: что показывают тесты производительности.

OnlyOffice против LibreOffice: что показывают тесты производительности.

Посмотрите, что могут — и чего не могут — доказать данные последних версий, а затем сравните оба офисных пакета на одних и тех же файлах и компьютере.

Calc VLOOKUP против XLOOKUP: выберите правильную формулу поиска

Сравните точные совпадения, поиск слева, обработку пропущенных значений и поддержку версий, чтобы выбрать надежную формулу Calc.

Номера страниц в Writer и Word: стили, разделы и перезапуск.

Номера страниц в Writer и Word: стили, разделы и перезапуск.

Узнайте, как стили страниц Writer и ссылки на разделы Word влияют на титульные страницы, римские цифры и нумерацию заново при перемещении документа.

Pardus Software Center или APT? Выбор правильного инструмента.

Pardus Software Center или APT? Выбор правильного инструмента.

Сравните возможности Pardus Software Center с командами APT для поиска, установки, удаления и обновления пакетов, используя метод, подходящий для вашей задачи.

Pardus 25.2 XFCE против GNOME: объективное сравнение оперативной памяти

Pardus 25.2 XFCE против GNOME: объективное сравнение оперативной памяти

Ознакомьтесь с опубликованными Pardus требованиями к оперативной памяти, а затем сравните XFCE и GNOME на одном и том же ПК, получив воспроизводимые значения MemAvailable.

Может ли HamoniKR OS удовлетворить потребности корпоративных настольных компьютеров?

Может ли HamoniKR OS удовлетворить потребности корпоративных настольных компьютеров?

Узнайте, какое место HamoniKR 8.0 занимает в тарифном плане для корпоративных компьютеров, какие функции, ориентированные на корейский язык, он поддерживает и что следует проверить перед более широким внедрением.

Безопасность Gooroom: что на самом деле делают доверенная загрузка и изоляция.

Безопасность Gooroom: что на самом деле делают доверенная загрузка и изоляция.

Разберитесь, как взаимодействуют проверка при загрузке и защита во время выполнения в Gooroom, что означает «песочница» и какие настройки следует проверять на вашем устройстве.