К статье
Практический материал

Другое · 9 мин

Как вывести ошибку в исключении 1С

Разбор способов получения и вывода текста ошибки в блоке исключения 1С: ОписаниеОшибки, ИнформацияОбОшибке, журнал регистрации и нюансы в коде.

В 1С:Предприятие обработка исключений строится на конструкции Попытка … Исключение … КонецПопытки. Если в защищаемом блоке возникает ошибка, выполнение передаётся в ветку Исключение, где можно получить текст сообщения и решить, показать ли его пользователю, записать в журнал или пробросить дальше.

Основной способ получить текст ошибки — функция ОписаниеОшибки(). Она возвращает строку с текстом последней ошибки в текущем контексте выполнения. Вызывать её следует только внутри блока Исключение; за пределами обработки результат может быть неопределённым или пустым.

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

Когда использовать блок Попытка Исключение

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

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

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

Как получить текст ошибки: ОписаниеОшибки и ИнформацияОбОшибке

Внутри блока Исключение вызовите ОписаниеОшибки() без параметров. Результат можно вывести через Сообщить, записать в переменную или передать в новое исключение. Этот метод подходит, когда достаточно краткого текста ошибки для пользователя или администратора.

Если требуется больше контекста, используйте ИнформацияОбОшибке(). Она позволяет получить структурированное описание ошибки, включая параметры и стек вызовов, в зависимости от реализации платформы. Подробный вывод полезен при отладке на сервере или при анализе инцидентов в журнале регистрации.

Пример получения текста в обработчике

Попытка
// действие, которое может вызвать ошибку
Исключение
ТекстОшибки = ОписаниеОшибки();
Сообщить("Ошибка: " + ТекстОшибки);
КонецПопытки;

Не вызывайте ОписаниеОшибки() до возникновения ошибки или после завершения обработчика, если не уверены, что контекст сохранён. В некоторых ситуациях текст может быть очищен при выходе из ветки Исключение, поэтому сохраняйте значение в переменную сразу после перехвата.

Вывод пользователю и запись в журнал регистрации

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

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

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

Место возникновенияВнутри Попытка

Ошибка перехватывается только если она произошла в защищаемом блоке

Доступ к текстуОписаниеОшибки()

Вызывайте в ветке Исключение, сразу после перехвата

Цель выводаПользователь или журнал

Выбирайте краткое сообщение для пользователя и подробную запись для администратора

Проброс исключения и создание собственного исключения

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

При пробросе сохраняйте исходный текст через ОписаниеОшибки(), иначе контекст может потеряться. Можно дополнить сообщение собственным комментарием, указав, в какой процедуре и при каких данных произошел сбой. Не изменяйте смысл ошибки, если это затруднит диагностику.

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

Ограничения, риски и типичные ошибки

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

Порядок действий
  1. 1
    Оберните рискованный код в Попытка … Исключение
  2. 2
    В ветке Исключение сохраните текст через ОписаниеОшибки()
  3. 3
    Выберите способ вывода: пользователю, журналу или пробросу
  4. 4
    Проверьте, что состояние данных осталось корректным

Распространённая ошибка — попытка обработать любое исключение одним блоком и продолжить выполнение. Это может привести к сохранению неполных данных или блокировке объектов. Перед продолжением проверяйте, что состояние программы позволяет безопасно двигаться дальше.

Ещё одна ошибка — вызов ОписаниеОшибки() вне блока Исключение или после выхода из него. Результат может быть пустым, и пользователь получит неинформативное сообщение. Всегда проверяйте, что обработчик действительно перехватил ошибку, прежде чем использовать её текст.

Сравнение вариантов

Сообщить пользователю

Подходит для интерактивных форм; ограничение — не выводите внутренние подробности

Запись в журнал регистрации

Подходит для сервера и фоновых заданий; не заменяет уведомление пользователя

Проброс через ВызватьИсключение

Подходит, когда текущий код не может исправить ошибку; требует сохранения исходного текста

Проверка результата и выбор способа вывода

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

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

Типичные ошибки
01
Вызов ОписаниеОшибки() вне блока Исключение — текст может быть пустым
02
Вывод необработанного текста ошибки пользователю — риск раскрытия внутренней структуры
03
Перехват всех исключений без проверки состояния может привести к некорректным данным.

Сравнение способов обработки ошибки

Разные задачи требуют разных способов реакции на исключение. Ниже приведено сопоставление основных вариантов и их границ применимости.

Типичные ошибки и как их избежать

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

Контрольные точки

Как проверить результат

Текст ошибки получен
Норма

Непустая строка внутри Исключение

Тревожный признак

Пустое значение или вызов вне обработчика

Запись в журнале
Норма

Есть запись с источником и временем

Тревожный признак

Отсутствует запись для фоновой операции

Состояние данных
Норма

Операция отменена или выполнена корректно

Тревожный признак

Продолжение выполнения после критической ошибки

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

Контрольные точки перед завершением

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

Итог

Что важно запомнить

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

Можно ли вызывать ОписаниеОшибки() за пределами блока Исключение?

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

Что делать, если текст ошибки пуст?

Проверьте, что вызов находится внутри той же ветки Исключение, где произошло исключение, и что значение не было перезаписано. Если текст всё равно отсутствует, используйте ИнформацияОбОшибке() или запишите сведения о месте возникновения сбоя вручную.

Нужно ли всегда записывать ошибку в журнал регистрации?

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

Можно ли продолжить выполнение после обработки исключения?

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