根本原因是混淆Docker客户端库与守护进程：pip install docker仅提供Python接口，宿主机必须运行Docker引擎，否则docker.from_env()抛DockerException；需先验证docker --version和docker ps是否正常。
pip install docker 失败或 import docker 报错
根本原因不是没装 docker 包，而是你混淆了「Docker 客户端库」和「Docker 守护进程」。装 pip install docker 只是让 Python 能发请求，但宿主机必须真有 Docker 引擎在跑，否则 docker.from_env() 会直接抛 docker.errors.DockerException: Error while fetching server API version。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先在终端跑
docker --version和docker ps，确认 Docker daemon 已启动（macOS/Windows 用 Desktop，Linux 确保systemctl is-active docker是active） - 如果用 WSL2，别只在 WSL 里装
docker包——WSL 默认连不到 Windows 上的 Docker Desktop，得配export DOCKER_HOST="tcp://localhost:2375"或直接启用 WSL2 backend - Mac M1/M2 用户注意：某些旧版
dockerPyPI 包不兼容 arm64，优先用pip install "docker>=6.0.0"
Dockerfile 里 pip install 总失败或环境不一致
本地 pip install -r requirements.txt 成功，一进容器就报 ModuleNotFoundError，大概率是路径、用户权限或构建阶段没对齐。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 别用
pip install -r requirements.txt一把梭——先COPY requirements.txt .，再RUN pip install --no-cache-dir -r requirements.txt，避免缓存导致依赖跳过安装 - Python 基础镜像选带
-slim后缀的（如python:3.11-slim），它不含gcc，装cryptography或psycopg2这类包会失败；要么换python:3.11-slim-bookworm，要么显式RUN apt-get update && apt-get install -y build-essential - 确保
WORKDIR和COPY . .顺序正确：先设工作目录，再复制代码，否则import mymodule会因路径不对找不到模块
容器启动后 Python 进程立刻退出（Exit 0）
不是代码崩溃，也不是端口冲突，而是容器把 python app.py 当成一次性命令执行完就收工。Docker 容器生命周期绑定主进程，主进程结束，容器就停。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 检查
CMD是否写成CMD ["python", "app.py"]——这没问题；但如果写成CMD python app.py（没加中括号），Shell 形式会触发 /bin/sh -c，容易被信号中断 - Web 应用务必监听
0.0.0.0:8000，不是127.0.0.1:8000；否则容器内能连，宿主机curl localhost:8000就超时 - 加健康检查：在
Dockerfile末尾加HEALTHCHECK --interval=30s --timeout=3s CMD curl -f http://localhost:8000/health || exit 1，方便快速定位是启动慢还是根本没起来
docker run -p 映射后访问不到服务
常见假象：docker run -p 8000:8000 启动了，docker ps 显示端口映射正常，但浏览器打不开——问题往往出在 Python 服务本身没暴露给外部网络，或者防火墙/SELinux 拦了。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- Flask/FastAPI 启动时必须显式指定
--host 0.0.0.0，比如uvicorn main:app --host 0.0.0.0 --port 8000；默认--host 127.0.0.1只接受容器内部请求 - Linux 上跑 Docker，检查
sysctl net.ipv4.ip_forward是否为 1；为 0 的话-p映射会静默失效 - Mac 用户遇到
connection refused，先docker network inspect bridge看容器 IP，再curl <container-ip>:8000——如果通，说明是宿主机到容器的 NAT 链路问题，重启 Docker Desktop 常能解决
最常被忽略的是：Python 服务日志没输出到 stdout，导致你根本不知道它卡在哪一行。务必在代码开头加 import logging; logging.basicConfig(level=logging.INFO)，并确保 print() 或 logger.info() 不被重定向。
