Белый экран или приложение не открывается на МФУ
title: Белый экран или приложение не открывается на МФУ slug: ts-vstroennoe-prilozhenie-belyy-ekran tags: [встроенное приложение, белый экран, не открывается, авторизация, Pantum, Kyocera, Ricoh] domain: Troubleshooting type: Troubleshooting audience: partner-engineer product_versions: "4.x" status: ready related_components: [Встроенное приложение, ПринтМенеджер] related_pages:
- kak-diagnostirovat-problemy-vstroennogo-prilozheniya
- ts-vstroennoe-prilozhenie-ne-ustanavlivaetsya
Белый экран или приложение не открывается на МФУ
Симптомы
- После нажатия иконки приложения на панели МФУ — белый экран или пустой экран без интерфейса.
- Приложение открывается, но экран авторизации не появляется.
- После ввода PIN-кода — белый экран вместо списка заданий.
Причины и решения
МФУ не может подключиться к серверу ПринтМенеджер
Белый экран — наиболее частый признак того, что приложение не получает ответ от ПринтМенеджер.
Проверить сетевой доступ МФУ к ПринтМенеджер:
- МФУ должен иметь доступ к серверу ПринтМенеджер по порту 8080 (или 1631 для CUPS).
- Проверить с рабочего места в той же подсети:
curl -k https://<ip_пм>:8080/.
Проверить статус контейнеров ПринтМенеджер:
cd /opt/printmanager
sudo docker-compose ps
Все контейнеры должны быть Up.
Несовместимая версия прошивки
На некоторых моделях (особенно Pantum) после обновления прошивки приложение перестаёт открываться. Или, наоборот, устаревшая прошивка несовместима с текущей версией приложения.
Решение: запросить у ТП совместимую версию прошивки для конкретной модели. Обновить или откатить прошивку.
Приложение не переустановлено после смены прошивки
После обновления прошивки МФУ встроенное приложение необходимо переустановить.
Решение:
- ЛК → «Удалить приложение».
- Перезагрузить МФУ.
- Установить приложение заново.
Конфликт со сторонним ПО на МФУ (Ricoh)
На Ricoh белый экран при авторизации по PIN-коду может быть вызван сторонними приложениями, установленными на МФУ (например, Device Software Manager).
Решение:
- Открыть веб-интерфейс МФУ → раздел установленных приложений.
- Удалить сторонние приложения, не связанные с Printum.
- Перезагрузить МФУ.
Как проверить результат
После перезагрузки МФУ открыть приложение — экран авторизации отображается корректно. Авторизация по PIN или карте выполняется успешно.
Когда эскалировать
- МФУ доступен по сети, контейнеры ПринтМенеджер работают, прошивка совместимая — белый экран сохраняется.
- Проблема воспроизводится только на одной модели МФУ.
Приложить к заявке: вендор, модель, версия прошивки, версии М и ПринтМенеджер, версия приложения, логи printmanager-app и printmanager-converter-server.