cat ~/blog/bitrix-module-update-checklist.md

Модуль обновился без ошибок, а экспорт всё равно завис

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

В одном из обновлений моего Excel-модуля установка прошла чисто. Файлы легли куда надо, номер версии изменился, админка открылась. Я запустил экспорт инфоблока и пошёл заниматься другими делами.

Через минуту на экране всё ещё висел running. Обработано ноль строк. Самое неприятное — ошибки не было даже в логе.

Виновник нашёлся в браузере. Скрипт попытался найти блок прогресса раньше, чем Битрикс вставил его в страницу. Не нашёл и спокойно завершился. Сервер вообще не получил запрос на экспорт, поэтому со стороны PHP всё выглядело прилично. После переноса запуска в DOMContentLoaded те же 38 элементов выгрузились штатно.

С тех пор фраза «обновление установлено» для меня означает только одно: можно начинать проверку.

Сначала повторяю то, что должно было измениться

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

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

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

Администратор видит слишком много

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

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

Потом иду туда, где ошибки не бросаются в глаза

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

Я отмечаю время начала проверки и смотрю только свежие записи. Иначе старый TypeError недельной давности внезапно становится главным подозреваемым. В браузере интересуют новые исключения JavaScript и запросы с неожиданным статусом. На сервере — журнал PHP и логи самого модуля.

Для фонового сценария записываю время подтверждённого выполнения. Строка в списке агентов сама по себе ничего не обработала.

С кешем тоже бывает смешно

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

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

Кнопка «Удалить модуль» не является откатом

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

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

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

Мой порядок после очередного обновления

  1. Сверить версию и прочитать описание изменений.
  2. Пройти исправленный сценарий до конечного результата.
  3. Повторить публичное действие без прав администратора.
  4. Дождаться связанных агентов или обменов.
  5. Посмотреть свежие ошибки PHP и JavaScript.
  6. Записать, что проверено и что осталось за рамками проверки.

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

man zelenkindev

Горячие клавиши

/
поиск по модулям
?
эта справка
Esc
закрыть