Ошибки 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, не используйте в нем данные из производственной среды, четко задокументируйте границы и используйте последние официальные данные о статусе и рекомендации службы поддержки при изменении ситуации.

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

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

Where to Study Cross-Border Digital Supply Chain Management: 7 Programs to Compare

Where to Study Cross-Border Digital Supply Chain Management: 7 Programs to Compare

Compare seven global programs for digital supply chains, logistics, analytics, global trade, and operations, with practical guidance on choosing the right fit.

От научной фантастики к реальности: как технология интерфейса мозг-компьютер восстанавливает мобильность и речь.

От научной фантастики к реальности: как технология интерфейса мозг-компьютер восстанавливает мобильность и речь.

Узнайте, как интерфейсы «мозг-компьютер» расшифровывают нейронные сигналы для восстановления коммуникации и движений, чего достигли недавние исследования и что по-прежнему ограничивает использование BCI.

Анатомия коммерческих дронов: аппаратные прорывы и автономный полет

Анатомия коммерческих дронов: аппаратные прорывы и автономный полет

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

Где лучше всего изучать проектирование систем хранения энергии? Сравнение 7 программ по аккумуляторным технологиям.

Где лучше всего изучать проектирование систем хранения энергии? Сравнение 7 программ по аккумуляторным технологиям.

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

Engineering the Sky: How Industrial UAVs Can Overcome Battery and Payload Constraints

Engineering the Sky: How Industrial UAVs Can Overcome Battery and Payload Constraints

Learn how payload mass, battery limits, weather, propulsion efficiency, and aircraft architecture shape industrial UAV endurance—and how to improve it.

Где изучать разработку интеллектуальных медицинских устройств: лучшие биомедицинские программы.

Где изучать разработку интеллектуальных медицинских устройств: лучшие биомедицинские программы.

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

Как разработать план обеспечения непрерывности бизнеса на случай простоя Salesforce

Как разработать план обеспечения непрерывности бизнеса на случай простоя Salesforce

Разработайте практичный план обеспечения бесперебойной работы Salesforce в случае простоя, с четко определенными приоритетами, резервными рабочими процессами, проверками восстановления, критериями тестирования и реалистичными ограничениями.

Возникли проблемы с StoreForce? Как розничные команды могут справиться со сбоями в управлении персоналом?

Возникли проблемы с StoreForce? Как розничные команды могут справиться со сбоями в управлении персоналом?

Проблемы с системой StoreForce могут нарушать графики работы, учет рабочего времени, смену смен и коммуникацию в магазине. Узнайте, как диагностировать проблему, обеспечить бесперебойную работу розничной торговли и проверить ее устранение.

Как связаться со службой поддержки Salesforce во время серьезного сбоя системы

Как связаться со службой поддержки Salesforce во время серьезного сбоя системы

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

Где лучше всего изучать финтех и кибербезопасность? Лучшие мировые программы на 2027 год.

Где лучше всего изучать финтех и кибербезопасность? Лучшие мировые программы на 2027 год.

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