← Назад к заметкам

Заметки

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

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

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

Задача

Разобрать практический сценарий в Bitrix24 без лишней теории.

Задача — как включить подробные ошибки без раскрытия пользователям. Логи, debug, окружение разработки.

Главное — не искать один универсальный метод, а сначала определить сущность, права и слой API, через который выполняется действие.

Как это устроено

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

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

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

Рабочий подход

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

Сделайте минимальный тест на одной сущности, сохраните входные данные и ответ метода, а затем расширяйте решение на массовый сценарий.

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

Частые ошибки

Частая ошибка — переносить решение из одной сущности в другую без проверки ID, типа владельца, прав и включённых модулей.

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