Ошибки Python и pip: что значит сообщение и как его исправить
Когда Python не может выполнить программу, а pip — поставить пакет, они пишут сообщение об ошибке. Найдите его текст в таблицах ниже и откройте разбор — там написано, что значит сообщение и какие команды ввести. Здесь же — как читать остальные строки.
Содержание 10
Что сделать прямо сейчас
- Найдите последнюю строку сообщения Python: в ней тип ошибки и текст, например
ModuleNotFoundError: No module named 'flask'. У pip ищите строку, которая начинается сERROR:илиerror:. - Найдите похожий текст в таблицах ниже и откройте разбор.
- Если сообщения на экране нет, а приложение не работает, найдите его в журнале — где искать сообщение.
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
Как читать сообщение
| Строка | Что значит |
|---|---|
Traceback (most recent call last): | начало сообщения Python; ниже — цепочка вызовов, последний вызов внизу |
File "/home/ivan/myapp/app.py", line 12, in <module> | файл, номер строки и функция; <module> — код вне функций |
| строка под строкой File | сама строка программы |
ModuleNotFoundError: No module named 'flask' | последняя строка: тип ошибки и её текст — по ним ищите в таблицах |
ERROR: … или error: … | pip не выполнил команду |
WARNING: … | предупреждение pip: команда выполняется дальше |
В строках File ищите снизу вверх первый путь к файлу вашего проекта, например /home/ivan/myapp/app.py: там и нужно исправлять. Пути, которые начинаются с /usr/lib/python3, и пути с site-packages или dist-packages относятся к самому Python и к библиотекам.
Если в сообщении есть строка During handling of the above exception, another exception occurred:, ошибок две: вторая случилась, пока программа разбирала первую. Причину ищите в первой.
У SyntaxError и IndentationError в запускаемом файле строки Traceback нет: сообщение начинается сразу со строки File.
Модули и импорт
| Сообщение | Что значит |
|---|---|
| ModuleNotFoundError: No module named '…' | библиотека не поставлена в тот Python, которым запущена программа, или не найден ваш файл |
| ImportError: cannot import name '…' | модуль найден, но нужного имени в нём нет: другая версия библиотеки, круговой импорт или файл назван как библиотека |
pip и установка пакетов
| Сообщение | Что значит |
|---|---|
| error: externally-managed-environment | pip не ставит пакеты в системный Python Ubuntu: нужно окружение venv |
| ensurepip is not available | окружение venv не создаётся: не поставлен пакет python3-venv |
| ERROR: Could not find a version that satisfies the requirement | pip не нашёл подходящую версию: опечатка в имени или нет версии для вашего Python |
| error: subprocess-exited-with-error | пакет собирается из исходников, и сборка упала |
Текст программы и файлы
| Сообщение | Что значит |
|---|---|
| IndentationError, TabError | ошибка в отступах |
| SyntaxError: invalid syntax | Python не может прочитать текст программы: пропущен знак или код написан для другой версии |
| UnicodeDecodeError: 'utf-8' codec can't decode byte | файл сохранён не в UTF-8 |
Запуск, порты и права
| Сообщение | Что значит |
|---|---|
| OSError: [Errno 98] Address already in use | порт занят другой программой; gunicorn пишет об этом Connection in use |
| PermissionError: [Errno 13] Permission denied | не хватает прав на файл, папку или порт с номером меньше 1024 |
| Reason: Worker failed to boot | gunicorn не смог загрузить приложение |
| Out of memory: Killed process | на сервере кончилась память, и ядро остановило программу; эта строка — в журнале ядра, а не в выводе Python |
Если приложение стоит за nginx и не запустилось, nginx показывает 502 Bad Gateway, а причину ищите в журнале приложения.
Где искать сообщение
Если программу запускали вручную, сообщение — прямо на экране, под командой. Если она работает службой systemd, сообщение — в журнале:
sudo journalctl -u myapp -n 50myapp — имя службы, подставьте своё. Подробнее — команда journalctl и как запустить приложение службой. Если программа пишет журнал в свой файл, откройте его конец командой tail — про cat, less и tail.
Откуда тексты
Тексты ошибок сверены с исходным кодом Python 3.12.3 — эта версия стоит в Ubuntu 24.04 — и Python 3.14.4 из пакета python3.14 в Ubuntu 26.04. Тексты сверены с исходным кодом pip 24.0 из пакетов Ubuntu 24.04 и pip 25.1.1 из пакетов Ubuntu 26.04. Тексты сверены с исходным кодом gunicorn 20.1.0 и 25.1.0 — эти версии ставятся из пакетов Ubuntu 24.04 и 26.04. Если gunicorn поставлен через pip в окружение venv, версия может быть другой. Свою версию покажут команды python3 --version и pip --version.
Источники
- Исходный код Python 3.12.3: Lib/traceback.py — строки Traceback, File и During handling of the above exception.
- Исходный код pip 24.0: utils/logging.py — приставки ERROR и WARNING.
- Исходный код pip 24.0: exceptions.py — строки вида error: externally-managed-environment.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Python, pip и venv на Ubuntuустановка и запуск приложения.
- Хостинг для Python и Node.jsчто выбрать под приложение.
- VPS для телеграм-ботаесли бот на Python.