...
Eroare Docker · Containere care se opresc imediat

ModuleNotFoundError: No module named 'flask'

Pe scurt

Aplicația Python pornește în container, dar pachetul flask nu e instalat în imagine, așa că se oprește imediat cu Exited (1). Adaugă în Dockerfile COPY requirements.txt . și RUN pip install --no-cache-dir -r requirements.txt, apoi reconstruiește imaginea.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Imaginea python conține doar interpretorul și biblioteca standard. Pachetele pe care le ai pe calculator (instalate cu pip sau într-un mediu virtual) nu ajung în imagine: trebuie instalate la build, într-un pas RUN pip install.

Traceback-ul apare în docker logs, iar containerul are starea Exited (1). Prima linie din stivă (File "/app/app.py", line 1) arată importul care a eșuat.

Cauzele tipice: lipsește RUN pip install din Dockerfile; requirements.txt nu conține pachetul (ai uitat pip freeze după instalare); instalarea se face în altă etapă a unui build multi-stage decât cea finală; sau pachetul e instalat cu alt Python decât cel care rulează aplicația (de exemplu apt-get install python3-flask pentru /usr/bin/python3, dar rulezi /usr/local/bin/python).

De ce apare: cauzele frecvente

1Dockerfile fără pip install

Greșit
BASH
FROM python:3.12-slim
WORKDIR /app
COPY . .
CMD ["python", "app.py"]
Corect
BASH
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "app.py"]

Pachetele din requirements.txt se instalează în imagine la build.

2Pachetul lipsește din requirements.txt

Greșit
BASH
# requirements.txt
requests
Corect
BASH
# requirements.txt
flask
requests

pip install -r instalează doar ce e scris în fișier.

3Instalat doar în etapa de build

Greșit
BASH
FROM python:3.12 AS build
RUN pip install flask
FROM python:3.12-slim
COPY app.py .
Corect
BASH
FROM python:3.12 AS build
RUN pip install --prefix=/install flask
FROM python:3.12-slim
COPY --from=build /install /usr/local
COPY app.py .

Imaginea finală pornește de la zero; pachetele trebuie copiate explicit din etapa de build.

Repară tu

Repară eroarea, direct în pagină

API-ul Flask din ~/api are requirements.txt cu flask, dar containerul api se oprește imediat, iar docker logs api arată ModuleNotFoundError: No module named 'flask'. Repară Dockerfile-ul ca să instaleze dependențele, reconstruiește api:1.0 și pornește din nou api pe portul 5000.

Indiciu

Copiază requirements.txt și rulează pip install -r requirements.txt înainte de COPY . ..

Alte forme ale mesajului

  • ModuleNotFoundError: No module named 'requests'
  • ModuleNotFoundError: No module named 'psycopg2'
  • Error: While importing 'app', an ImportError was raised

Cum o eviți pe viitor

Ține toate dependențele în requirements.txt (cu versiuni fixate) și instalează-le în Dockerfile, într-un pas separat, înainte de COPY . ., ca să profiți de cache. După build, verifică rapid cu docker run --rm imagine pip list sau python -c "import flask". Nu te baza pe pachetele de pe calculatorul tău: imaginea trebuie să conțină tot.

Întrebări frecvente

Pe calculator aplicația merge. De ce în container nu?

Containerul are propriul Python, din imagine. Pachetele instalate pe calculator, global sau într-un venv, nu sunt copiate în imagine; trebuie instalate în Dockerfile.

De ce copiez întâi doar requirements.txt?

Pentru cache: dacă schimbi doar codul, pasul pip install rămâne CACHED, iar build-ul durează câteva secunde în loc de minute.

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.