Ошибки
Приложение не запустилось
start_failed — собралось, но приложение или бот остановились после запуска или не ответили. Частые причины.
start_failed — сборка прошла, но приложение не ответило за минуту или бот остановился после запуска. Причина — на странице Логи: последнее, что сказало приложение, и часто под ним строка Совет:. Старая версия веб-приложения продолжает работать. У бота старая версия останавливается до запуска новой: две копии, опрашивающие Telegram, мешают друг другу. Поэтому бот не работает до следующего успешного деплоя.
Не задана переменная
Самая частая причина. Приложение ждёт значение вроде BOT_TOKEN, DATABASE_URL, SECRET_KEY. Имя видно в логе: KeyError: 'BOT_TOKEN', Field required от pydantic, Could not resolve placeholder от Spring. Добавьте его в Настройки → Переменные и задеплойте снова. Файл .env в репозиторий не попадает — значения пишутся туда.
Токен бота пустой или неверный
В логе TokenValidationError или InvalidToken. Положите токен от BotFather в Переменные под тем именем, которое читает код (часто BOT_TOKEN).
Python не нашёл модуль
В логе No module named 'X'. Если это библиотека — добавьте её в requirements.txt. Имя импорта и имя пакета иногда различаются:
| Импорт | В requirements.txt |
|---|---|
PIL |
Pillow |
cv2 |
opencv-python-headless |
yaml |
PyYAML |
dotenv |
python-dotenv |
telegram |
python-telegram-bot |
Если это ваша папка (config, data), проверьте, что она закоммичена с файлами и .gitignore её не выкинул.
Приложение слушает localhost
Тогда оно доступно только самому контейнеру. Слушайте 0.0.0.0 и порт из переменной PORT:
app.listen(process.env.PORT || 3000, '0.0.0.0')
uvicorn main:app --host 0.0.0.0 --port $PORT
Приложение ждёт базу
В логе ECONNREFUSED 127.0.0.1:5432 или Connection refused. Добавьте базу в проект (Базы) или укажите адрес внешней базы в DATABASE_URL.
В базе нет таблиц
В логе no such table или relation ... does not exist. Поставьте миграцию в Команду перед деплоем:
.venv/bin/python manage.py migrate --noinput
Django отклоняет адрес
В логе DisallowedHost. В settings.py:
ALLOWED_HOSTS = os.environ.get('ALLOWED_HOSTS', '').split(',')
и в Переменных ALLOWED_HOSTS=.livops.app.
Не хватило памяти
Приложение заняло больше памяти, чем разрешает тариф, и было остановлено (в логе Killed или код выхода 137). Выберите тариф побольше в Настройках или уменьшите потребление памяти.
Программа завершилась сама
Бот ничего не вывел и завершился с кодом 0 — выполнился до конца. Так ведут себя библиотека, разовый скрипт или консольная утилита. Бот должен работать постоянно: start_polling(), bot.launch(), bot.start(). Проверьте, что команда запуска запускает самого бота.
Программа задала вопрос и ждёт
В последней строке (y/N) или Press enter. Здесь никто не ответит. Передайте ответ параметром или переменной.
Файлы пропадают при каждом деплое
Файлы в /tmp или рядом с кодом удаляются при следующем деплое. Пишите их в /app/data (переменная DATA_DIR) или в базу. См. Файлы.
predeploy_failed
Команда перед деплоем (например, миграция) завершилась с ошибкой. Новая версия не запущена, старая работает. Что она сказала — в логе.