Проблемы предпросмотра

Определите, где возникла ошибка

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

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

Что означают ошибки шлюза?

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

503 Service Unavailable может появляться при запуске или недоступности приложения. 502 Bad Gateway указывает на ошибку прокси или протокола вышестоящего сервиса. Фиксируйте настоящий код, не объединяйте все ошибки в одну.

Приложение может отвечать на локальную проверку здоровья, пока публичный маршрут не работает. Поэтому «локально получен HTTP 200» не доказывает работу встроенного предпросмотра.

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

Восстановление без потери работы

1. Дождитесь завершения активной подготовки или намеренного перезапуска.
2. Используйте доступное действие повтора и проверьте приложение и маршрут.
3. Если ошибка остаётся, попросите Amazi проверить запуск, настройки приложения, настроенный порт, публичную маршрутизацию и точный неработающий URL. Amazi может самостоятельно проверить доступные сведения об ошибке запуска; вам не нужно искать серверный журнал или отправлять в чат пароли и ключи.
4. Если безопасное исправление не найдено, передайте сведения через Диагностику и поддержку.

Не удаляйте проект, не сбрасывайте базу и не запускайте многократно новые платные задачи только ради исчезновения ошибки. Время запуска зависит от необходимых работ; бесконечное состояние «запускается» требует диагностики, а не признания нормой.

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

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

Встроенный просмотр и отдельная вкладка

Preview находится во фрейме другого origin. Перенаправления входа, cookies и ограничения браузера могут работать иначе, чем при открытии того же адреса отдельно.

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

Почему картинка карточки старая?

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

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

Изменения Preview не равны публикации

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