结论：Docker中运行pytest需同步源码、依赖、路径和PYTHONPATH，否则必报ModuleNotFoundError或ImportError；核心是确保容器内sys.path包含项目根目录且WORKDIR与COPY一致。
怎么写Dockerfile让pytest在容器里跑起来
直接说结论：不能只装pytest，得把项目源码、依赖、测试路径全对齐，否则ModuleNotFoundError或ImportError是常态。关键不是“能不能跑”，而是“跑的是不是你本地写的那个测试”。
常见错误现象：pytest: command not found（没装pytest）、No module named 'myproject'（PYTHONPATH或工作目录不对）、test_*.py not found（测试文件没挂载或路径错）。
- 基础镜像选
python:3.9-slim或python:3.11，别用alpine除非你确认所有C扩展兼容 -
COPY . /app之后必须WORKDIR /app，否则pytest默认从/开始找测试文件 - 用
RUN pip install --no-cache-dir -e .安装项目（含setup.py或pyproject.toml），确保可导入模块；如果没打包配置，就RUN pip install --no-cache-dir -r requirements.txt再COPY . . - 测试命令写成
CMD ["pytest", "tests/", "-v"]，别用bash -c "pytest..."——CMD被覆盖或信号转发会出问题
为什么pytest找不到我的测试模块
根本原因：容器内Python解释器的sys.path不包含你的项目根目录，而pytest默认只把当前目录加进sys.path。你在本地能跑，是因为IDE或shell当前路径碰巧对了。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 检查
WORKDIR是否和COPY目标一致，比如COPY . /src但WORKDIR /app，那代码根本不在工作区 - 运行容器时加
-v $(pwd):/app做覆盖挂载，比重建镜像快，适合调试阶段 - 临时验证路径：改
CMD为["python", "-c", "import sys; print(sys.path)"]，看输出里有没有/app - 如果项目结构是
src/myproject/，需在pyproject.toml里配[tool.setuptools.package-dir] "" = "src"，或启动时加PYTHONPATH=/app/src
如何让Docker里的pytest支持coverage和junitxml输出
只要pip装了对应包，参数照常传就行，但注意输出路径得映射到宿主机，否则容器删了报告就没了。
示例片段：
RUN pip install --no-cache-dir pytest-cov pytest-junitxml CMD ["pytest", "tests/", "--cov=myproject", "--cov-report=html:/app/htmlcov", "--junitxml=/app/test-results.xml", "-v"]
-
--cov-report=html:/app/htmlcov后，运行完用docker cp 容器ID:/app/htmlcov ./htmlcov拉出来 -
--junitxml路径必须是容器内存在的目录（如/app），且test-results.xml要写在文件名位置，不能写成--junitxml ./test-results.xml（相对路径在容器里可能错） - 如果用
pytest-xdist并发，注意某些插件（如pytest-cov）需额外配--cov-config或环境变量COVERAGE_PROCESS_START
CI里跑Docker pytest容易忽略的三件事
本地能过不代表CI稳——网络、权限、时间戳三个点最常翻车。
- Docker in Docker（DinD）场景下，
pytest若调用subprocess.run(['docker', ...])，得加--privileged或挂载/var/run/docker.sock，否则Permission denied - 某些测试读写
/tmp或生成缓存，Alpine镜像默认/tmp是tmpfs，重启即丢，建议显式mkdir -p /app/.cache并配--cache-dir /app/.cache - Git clone的文件时间戳在容器里可能是1970年，导致
pytest的--last-failed或--lf失效，CI中应避免依赖这些选项
python -c "import myproject; print(myproject.__file__)"，比查文档快十倍。 
