Поиск
Ошибки

Ошибки Python и pip: что значит сообщение и как его исправить

Когда Python не может выполнить программу, а pip — поставить пакет, они пишут сообщение об ошибке. Найдите его текст в таблицах ниже и откройте разбор — там написано, что значит сообщение и какие команды ввести. Здесь же — как читать остальные строки.

≈ 5 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Найдите последнюю строку сообщения Python: в ней тип ошибки и текст, например ModuleNotFoundError: No module named 'flask'. У pip ищите строку, которая начинается с ERROR: или error:.
  2. Найдите похожий текст в таблицах ниже и откройте разбор.
  3. Если сообщения на экране нет, а приложение не работает, найдите его в журнале — где искать сообщение.

Команды на этой странице вводятся на сервере: подключитесь к нему по 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-environmentpip не ставит пакеты в системный Python Ubuntu: нужно окружение venv
ensurepip is not availableокружение venv не создаётся: не поставлен пакет python3-venv
ERROR: Could not find a version that satisfies the requirementpip не нашёл подходящую версию: опечатка в имени или нет версии для вашего Python
error: subprocess-exited-with-errorпакет собирается из исходников, и сборка упала

Текст программы и файлы

СообщениеЧто значит
IndentationError, TabErrorошибка в отступах
SyntaxError: invalid syntaxPython не может прочитать текст программы: пропущен знак или код написан для другой версии
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 bootgunicorn не смог загрузить приложение
Out of memory: Killed processна сервере кончилась память, и ядро остановило программу; эта строка — в журнале ядра, а не в выводе Python

Если приложение стоит за nginx и не запустилось, nginx показывает 502 Bad Gateway, а причину ищите в журнале приложения.

Где искать сообщение

Если программу запускали вручную, сообщение — прямо на экране, под командой. Если она работает службой systemd, сообщение — в журнале:

sudo journalctl -u myapp -n 50

myapp — имя службы, подставьте своё. Подробнее — команда 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.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше