ModuleNotFoundError: No module named 'flask'
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
FROM python:3.12-slim
WORKDIR /app
COPY . .
CMD ["python", "app.py"]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
# requirements.txt
requests# requirements.txt
flask
requestspip install -r instalează doar ce e scris în fișier.
3Instalat doar în etapa de build
FROM python:3.12 AS build
RUN pip install flask
FROM python:3.12-slim
COPY app.py .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ă 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 . ..
Reparația
cat > Dockerfile <<'EOF'
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "app.py"]
EOF
docker build -t api:1.0 .
docker rm -f api
docker run -d --name api -p 5000:5000 api:1.0
curl -s localhost:5000Salut din APIDe ce merge
Imaginea python:3.12-slim nu conține Flask, iar Dockerfile-ul copia doar codul, deci importul eșua la pornire. Cu RUN pip install --no-cache-dir -r requirements.txt, Flask se instalează în imagine la build. Containerul nou pornește serverul pe 0.0.0.0:5000, iar curl localhost:5000 primește răspunsul.
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
ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt' pip install -r requirements.txt rulează în build înainte ca fișierul să fie copiat în imagine (sau într-un WORKDIR diferit). Pune COPY requirements.txt . înaintea lui RUN pip install, în același WORKDIR, și verifică să nu fie exclus în .dockerignore. ERROR: Could not find a version that satisfies the requirement flsk (from versions: none) pip nu găsește pe PyPI niciun pachet sau nicio versiune potrivită pentru ce ai cerut: nume scris greșit (flsk), versiune inexistentă sau incompatibilă cu Python-ul din imagine, ori lipsă de acces la internet în build. Corectează linia din requirements.txt și reconstruiește. Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. python: can't open file '/app/app.py': [Errno 2] No such file or directory Containerul pornește python app.py în WORKDIR (/app), dar fișierul nu e acolo în imagine: lipsește COPY, a fost copiat în alt folder sau un volum montat peste /app îl ascunde. Adaugă COPY app.py . după WORKDIR /app, reconstruiește imaginea și pornește containerul din nou. Î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.
