Как вывести ошибку в исключении 1С: подробная инструкция

Работа с исключениями в 1С:Предприятие 8.3 — неотъемлемая часть разработки корректных и отказоустойчивых решений. Когда программа сталкивается с нештатной ситуацией, правильное отображение ошибки помогает не только пользователю понять проблему, но и разработчику быстрее локализовать баг. Однако стандартные сообщения об ошибках зачастую содержат минимальную информацию, что затрудняет диагностику.

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

Материал будет полезен как начинающим разработчикам 1С, так и опытным специалистам, которые хотят систематизировать свои знания. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3.23 и выше. Если вы работаете со старшими релизами, некоторые методы могут требовать адаптации — об этом мы тоже упомянем в соответствующих разделах.

1. Базовый синтаксис обработки исключений в 1С

Конструкция Попытка...Исключение — основа работы с ошибками в 1С. Она позволяет "поймать" исключение и выполнить альтернативный код вместо аварийного завершения программы. Минимальный синтаксис выглядит так:

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

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

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

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

Попытка
Результат = НесуществующаяФункция();
Исключение
Ошибка = ИнформацияОбОшибке();
Сообщить(СтрШаблон("Ошибка: %1
Модуль: %2
Строка: %3",
Ошибка.Описание, Ошибка.Модуль, Ошибка.НомерСтроки));
КонецПопытки;

💡

Всегда включайте в обработчик исключений запись в журнал регистрации через ЗаписатьЖурналРегистрации() — это поможет отслеживать ошибки в продуктивной базе, где пользователи могут проигнорировать сообщение Сообщить().

2. Расширенные методы получения информации об ошибке

Функция ОписаниеОшибки() возвращает строку с полным описанием последней возникшей ошибки, включая вложенные исключения. Это особенно полезно, когда ошибка происходит в цепочке вызовов серверных процедур или при работе с COM-объектами:

Попытка
ПодключитьВнешнююКомпоненту("НесуществующийФайл.dll");
Исключение
ПолноеОписание = ОписаниеОшибки();
ЗаписатьЛог(ПолноеОписание); // Сохраняем в файл или базу данных
Сообщить(Лев(ПолноеОписание, 200) + "..."); // Показываем пользователю сокращённую версию
КонецПопытки;

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

Попытка
ВыполнитьОпаснуюОперацию();
Исключение
Ошибка = ИнформацияОбОшибке();
Для Каждого Вызов Из Ошибка.СтекВызовов Цикл
ЗаписатьЖурналРегистрации(Вызов, УровеньЖурнала.Ошибка);
КонецЦикла;
КонецПопытки;

Метод получения информации	Возвращаемый тип	Пример использования	Особенности
`ОписаниеОшибки()`	Строка	`Сообщить(ОписаниеОшибки());`	Включает все вложенные исключения, но без структурированных данных
`ИнформацияОбОшибке()`	Структура	`Ошибка = ИнформацияОбОшибке();`	Содержит модуль, строку, тип ошибки и стек вызовов
`ИнформацияОбОшибке().СтекВызовов`	Массив строк	`Для Каждого Вызов Из Ошибка.СтекВызовов Цикл`	Позволяет проанализировать цепочку вызовов, приведшую к ошибке
`СтатусВыполнения()`	Число	`Если СтатусВыполнения() = 2 Тогда`	Возвращает 2 при возникновении исключения в текущем потоке

3. Вывод ошибок в пользовательском интерфейсе

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

📌 Предупреждения через ПоказатьПредупреждение() — для некритичных ошибок
📌 Окна сообщений с кнопками через ПоказатьВопрос() — когда нужно подтверждение пользователя
📌 Статусные панели — для отображения технических ошибок без прерывания работы

Пример кастомизированного вывода ошибки с предложением решений:

Попытка
ЗагрузитьДанныеИзФайла(ПутьКФайлу);
Исключение
Ошибка = ИнформацияОбОшибке();

ТекстСообщения = "Не удалось загрузить файл: " + ?(ПустаяСтрока(Ошибка.Описание),
"неизвестная ошибка", Ошибка.Описание) + "
Попробуйте:
1. Проверить путь к файлу
2. Убедиться, что файл не открыт в другой программе
3. Повторить попытку позже";

Результат = ПоказатьВопрос(ТекстСообщения, , "Повторить|Отмена");
Если Результат = 0 Тогда
ЗагрузитьДанныеИзФайла(ПутьКФайлу); // Повторный вызов
КонецЕсли;
КонецПопытки;

⚠️ Внимание: Никогда не показывайте пользователям технические детали ошибок (номера строк, имена процедур, пути к файлам) в продуктивных системах. Это создаёт риски безопасности и путает нетехнических пользователей. Используйте такие данные только в логах для администраторов.

4. Логирование ошибок для последующего анализа

Системное логирование — ключевой элемент поддержки 1С-решений. В платформе есть несколько встроенных механизмов:

Журнал регистрации — через ЗаписатьЖурналРегистрации() или ЗаписатьЛог() (для файлового логирования)
Регистрация событий — через планы обмена или специализированные регистры сведений
Внешние системы — отправка ошибок в Sentry, ELK или другие сервисы мониторинга

Пример комплексного логирования с сохранением в журнал и файл:

Процедура ЗаписатьОшибкуВЛог(Ошибка, ДополнительнаяИнформация = "") ТекстЛога = СтрШаблон("Ошибка: %1 Модуль: %2 Строка: %3 Дополнительно: %4 Стек: %5", Ошибка.Описание, Ошибка.Модуль, Ошибка.НомерСтроки, ДополнительнаяИнформация, Строка(Ошибка.СтекВызовов)); // 1. Запись в журнал регистрации 1С ЗаписатьЖурналРегистрации(ТекстЛога, УровеньЖурнала.Ошибка, , , "ОшибкиПриложения"); // 2. Запись в текстовый файл (для резервного хранения) ПутьКФайлуЛога = КаталогПрограммы() + "Logs\Errors.log"; ЗаписатьТекст(ПутьКФайлуЛога, ТекстЛога, КодировкаТекста.UTF8, РежимЗаписиТекста.Добавить); // 3. Отправка во внешнюю систему (пример для Sentry) Попытка HTTPЗапрос = Новый HTTPЗапрос("https://sentry.io/api/..."); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЛога); HTTPСоединение = Новый HTTPСоединение; Ответ = HTTPСоединение.Получить(HTTPЗапрос); Исключение // Если ошибка при отправке - игнорируем, главное сохранили локально КонецПопытки;

КонецПроцедуры;

Уникальный идентификатор ошибки (GUID)

Дата и время возникновения

Тип и описание ошибки

Модуль и строка кода

Данные контекста (параметры вызова, значения переменных)-->

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

📊 Топ-10 самых частых ошибок за период
📊 Динамику возникновения ошибок по дням/неделям
📊 Связь ошибок с конкретными пользователями или ролями

5. Типичные ошибки при работе с исключениями

Даже опытные разработчики 1С иногда допускают ошибки при обработке исключений. Вот наиболее распространённые проблемы и как их избежать:

Ошибка	Последствия	Как исправить
Пустой блок `Исключение`	Ошибка "глотается", проблема остаётся незамеченной	Всегда логируйте или показывайте ошибку, даже если не можете её обработать
Использование `Продолжить` в блоке `Исключение`	Код после `КонецПопытки` выполнится, как будто ошибки не было	Используйте `Продолжить` только если уверены, что состояние программы корректно
Ловля всех исключений одним блоком	Трудно диагностировать первопричину, особенно при вложенных ошибках	Используйте несколько блоков `Попытка` для разных типов операций
Вывод технических деталей пользователям	Путает пользователей, создаёт риски безопасности	Показывайте только понятные сообщения, технические детали — в логи

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

Попытка // Основной код Исключение ОригинальнаяОшибка = ИнформацияОбОшибке(); // Сохраняем сразу! Попытка // Код обработки ошибки, который тоже может упасть ОтправитьУведомлениеОбОшибке(ОригинальнаяОшибка); Исключение // Здесь мы всё ещё имеем доступ к ОригинальнаяОшибка ЗаписатьВЛог(ОригинальнаяОшибка, "Ошибка при обработке: " + ОписаниеОшибки()); КонецПопытки;

КонецПопытки;

⚠️ Внимание: В версиях 1С:Предприятие ниже 8.3.10 функция ИнформацияОбОшибке() не возвращает стек вызовов для серверных процедур. Если вам нужна поддержка старых версий, реализуйте собственную трассировку через обёртки процедур.

6. Продвинутые техники: создание собственных классов ошибок

Для крупных проектов полезно создавать собственные классы ошибок, которые будут инкапсулировать логику обработки и предоставлять удобные методы для логирования. Например:

Перем мЭкземплярОбработчикаОшибок;

Процедура ПриСозданииОбъекта()
мЭкземплярОбработчикаОшибок = Новый ОбработчикОшибок();
КонецПроцедуры

Процедура ВыполнитьКритическуюОперацию()
Попытка
// Код, который может вызвать ошибку
ПодключитьсяКВнешнемуСервису();
Исключение
мЭкземплярОбработчикаОшибок.Обработать(
ИнформацияОбОшибке(),
"КритическаяОперация",
ЭтотОбъект.ТекущийПользователь());
Возврат Ложь;
КонецПопытки;

Возврат Истина;
КонецПроцедуры;

Реализация класса ОбработчикОшибок может включать:

🔧 Автоматическое определение уровня критичности ошибки
🔧 Маршрутизацию уведомлений (кому отправлять: администратору, разработчику, пользователю)
🔧 Интеграцию с системами тикетов (Jira, Redmine)
🔧 Механизмы повторных попыток для временных сбоев

Пример реализации метода ПовторитьПриОшибке

Процедура ПовторитьПриОшибке(Действие, МаксПопыток = 3, ЗадержкаСек = 1)

Попытка = 1;

ПоследняяОшибка = Неопределено;

Пока Попытка <= МаксПопыток Цикл

Попытка

Возврат Действие.Выполнить();

Исключение

ПоследняяОшибка = ИнформацияОбОшибке();

Если Попытка < МаксПопыток Тогда

Подождать(ЗадержкаСек);

КонецЕсли;

КонецПопытки;

Попытка = Попытка + 1;

КонецЦикла;

ВызватьИсключение ПоследняяОшибка.Описание;

КонецПроцедуры;

Такой подход особенно полезен при работе с внешними системами (веб-сервисами, оборудованием), где временные сбои — нормальная ситуация. Например, при обмене данными с 1С:EDT или Диадок можно автоматически повторять запрос несколько раз перед тем, как фиксировать ошибку.

7. Интеграция с системами мониторинга

Для промышленной эксплуатации 1С-решений критически важно настраивать интеграцию с системами мониторинга. Это позволяет:

📈 Отслеживать частоту возникновения ошибок в реальном времени
📈 Коррелировать ошибки с нагрузкой на систему
📈 Автоматически эскалировать критические проблемы

Популярные решения для интеграции:

Система	Преимущества	Как интегрировать
Sentry	Удобный интерфейс, группировка похожих ошибок, уведомления в Slack/Telegram	Через HTTP-запросы к их API с передачей данных об ошибке в JSON
ELK Stack	Гибкий поиск по логам, визуализация данных в Kibana	Отправка логов в Logstash или напрямую в Elasticsearch
Zabbix	Мониторинг доступности, триггеры на критические ошибки	Через Zabbix Sender или внешние скрипты
1С:Линк	Специализированное решение для 1С, интеграция с 1С:Fresh	Через стандартные механизмы обмена данными

Пример отправки ошибки в Sentry:

Функция ОтправитьВSentry(Ошибка, ДополнительныеДанные = Неопределено)
URL = "https://ооррsss@sentry.io/1234567";
Заголовки = Новый Соответствие;
Заголовки.Вставить("Content-Type", "application/json");

Тело = Новый Структура;
Тело.Вставить("event_id", Строка(Новый УникальныйИдентификатор));
Тело.Вставить("level", "error");
Тело.Вставить("logger", "1c-application");
Тело.Вставить("message", Ошибка.Описание);
Тело.Вставить("extra", Новый Структура("stacktrace,Ошибка.СтекВызовов,
"context", ДополнительныеДанные));

Запрос = Новый HTTPЗапрос(URL);
Запрос.УстановитьТелоИзСтроки(ЗаписатьJSON(Тело));
Запрос.УстановитьЗаголовки(Заголовки);

Попытка
Ответ = Новый HTTPСоединение.Получить(Запрос);
Если Ответ.КодСостояния <> 200 Тогда
ЗаписатьЖурналРегистрации("Ошибка отправки в Sentry: " + Ответ.ПолучитьТекст(),
УровеньЖурнала.Ошибка);
КонецЕсли;
Исключение
ЗаписатьЖурналРегистрации("Не удалось отправить ошибку в Sentry: " + ОписаниеОшибки(),
УровеньЖурнала.Ошибка);
КонецПопытки;
КонецФункции;

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

8. Практические рекомендации по отладке

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

Эффективные приёмы отладки:

🛠️ Пошаговое выполнение (F11) с заходом в блок Исключение
🛠️ Просмотр значений переменных в момент возникновения ошибки
🛠️ Использование точек останова с условием на конкретные типы ошибок
🛠️ Тестирование кода с искусственным вызовом исключений через ВызватьИсключение

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

Процедура ТестироватьОбработкуОшибок()
// Тест 1: Деление на ноль
Попытка
Результат = 1 / 0;
Исключение
ОбработатьОшибку(ИнформацияОбОшибке(), "ДелениеНаНоль");
КонецПопытки;

// Тест 2: Ошибка типа
Попытка
СтроковаяПеременная = "привет";
Число = СтроковаяПеременная + 10;
Исключение
ОбработатьОшибку(ИнформацияОбОшибке(), "ОшибкаТипа");
КонецПопытки;

// Тест 3: Ошибка доступа к файлу
Попытка
ПрочитатьТекст("C:\несуществующий_файл.txt");
Исключение
ОбработатьОшибку(ИнформацияОбОшибке(), "ОшибкаФайла");
КонецПопытки;
КонецПроцедуры;

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

💡

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

FAQ: Частые вопросы по работе с исключениями в 1С

Как отличить критические ошибки от предупреждений?

В 1С нет встроенной классификации ошибок по критичности, но вы можете реализовать её самостоятельно. Например:

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

Пример:

Функция ОпределитьУровеньОшибки(Ошибка)
ТекстОшибки = НРег(Ошибка.Описание);

Если Найти(ТекстОшибки, "деление на ноль") <> 0 Тогда
Возврат УровниОшибок.Критическая;
ИначеЕсли Найти(ТекстОшибки, "файл не найден") <> 0 Тогда
Возврат УровниОшибок.Предупреждение;
КонецЕсли;

Возврат УровниОшибок.Критическая; // По умолчанию критические
КонецФункции;

Можно ли ловить ошибки, которые возникают в транзакциях?

Да, но важно понимать, что если ошибка произошла внутри транзакции, все изменения будут отменены при выходе из блока Исключение (если не использован ЗафиксироватьТранзакцию()). Пример:

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

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

Как обработать ошибки при работе с COM-объектами?

Ошибки в COM-объектах (например, при работе с Excel или Word) требуют особого подхода, так как они могут не попадать в стандартный блок Исключение. Используйте:

Попытка
Excel = Новый COMОбъект("Excel.Application");
Исключение
Если ТипЗнч(Ошибка) = Тип("COMОбъектОшибка") Тогда
Сообщить("COM Ошибка: " + Ошибка.Описание + "
Код: " + Ошибка.Код);
КонецЕсли;
КонецПопытки;

Для Excel и Word полезно проверять свойство Error после выполнения операций:

Если Excel.Error <> 0 Тогда
Сообщить("Ошибка Excel: " + Excel.ErrorDescription);
КонецЕсли;

Что делать, если ошибка происходит в фоновом задании?

В фоновых заданиях блок Исключение работает так же, как и в обычном коде, но:

Сообщения через Сообщить() не показываются пользователю
Ошибки записываются в журнал регистрации с пометкой "Фоновое задание"
Для уведомления пользователя нужно использовать механизмы обмена сообщениями

Пример обработки ошибки в фоновом задании с уведомлением:

Процедура ВыполнитьФоновоеЗадание(Параметры) Экспорт Попытка // Основной код задания Исключение Ошибка = ИнформацияОбОшибке(); ЗаписатьЖурналРегистрации(Ошибка.Описание, УровеньЖурнала.Ошибка,,,"ФоновыеЗадания"); // Отправляем уведомление инициатору задания ТекстУведомления = "Ошибка в фоновом задании '" + Параметры.Название + "': " + Ошибка.Описание; ОтправитьУведомлениеПользователю(Параметры.Инициатор, ТекстУведомления); КонецПопытки;