CI中pytest找不到测试文件或报错，主因是工作目录与Python路径不一致、缺少__init__.py、环境变量缺失、临时文件并发冲突及coverage路径配置错误。
pytest 在 CI 中找不到测试文件
CI 环境里 pytest 报 No module named 'tests' 或直接跳过所有测试，通常不是代码问题，而是工作目录和 Python 路径没对齐。本地能跑是因为你习惯性在项目根目录执行，而 CI 的 job 往往从仓库根启动，但某些镜像（比如 python:slim）默认不把当前目录加进 PYTHONPATH。
- 确保 CI 脚本中显式进入项目根目录：
cd /workspace或cd $(git rev-parse --show-toplevel) - 运行
pytest时加-s和--tb=short，避免因输出截断掩盖路径错误 - 如果用
src/结构，必须配pyproject.toml里的[tool.pytest.ini_options]加pythonpath = ["src"]，否则import mypackage会失败 - 检查
__init__.py：CI 不认隐式命名空间包，tests/下没__init__.py就不算包，pytest可能跳过它
测试因环境变量或配置缺失而随机失败
本地通过、CI 失败的测试，八成卡在读取 os.environ、.env 文件或硬编码路径上。CI 没有你的 shell profile、没装 direnv、也没 .env 提交到仓库——这是最常被忽略的隐性依赖。
- 禁止在测试里直接调
os.getenv('DB_URL')；改用 pytest 的monkeypatch.setenv()显式注入，或用pytest-env插件统一管理 -
.env文件绝不能提交，但 CI 需要等效配置：GitHub Actions 用env:块，GitLab CI 用variables:，值统一走 secrets - 路径相关逻辑（比如
Path(__file__).parent / '../data'）在 CI 容器里容易越界，改用importlib.resources.files(mypackage).joinpath('data')（Python 3.9+）更可靠
并发测试写临时文件导致冲突
CI 机器常开多 job 并行，或单 job 内 pytest-xdist 启多个 worker，如果测试都往 /tmp/test.db 写，必然抢资源、报 PermissionError 或数据污染。
- 永远用
tempfile.mkstemp()或tempfile.TemporaryDirectory()，别拼字符串路径 - 如果必须用固定名（如 SQLite），给每个 test session 加唯一后缀：
f"test_{os.getpid()}.db"，或者直接用:memory:模式 -
pytest-xdist下，tmp_pathfixture 是每个 worker 隔离的，放心用；但tmpdir（旧版）不是，得换 - 注意 Docker CI 场景：容器内
/tmp可能是 tmpfs，大小有限，大文件测试要提前df -h /tmp检查
coverage 报告上传失败或数值异常低
CI 里 coverage run -m pytest 成功，但 coverage report 显示 0%，或上传 codecov 时报 no coverage data found，本质是覆盖率采集没覆盖到实际执行的代码路径。
立即学习“Python免费学习笔记（深入）”；
- 确认
coverage运行时的--source指向的是安装后的包路径（如src/mypackage），不是开发时的.；CI 里常先pip install -e .，那--source应该是包名mypackage - 如果用了
poetry或pipx，确保coverage和pytest在同一 Python 环境——CI 脚本里别混用python -m pytest和coverage run pytest - CI 的
coverage.xml必须在 upload 步骤前生成，且路径别被 cleanup 覆盖；建议显式指定：coverage xml -o coverage.xml - 某些 CI 平台（如 CircleCI）默认清理
~/.cache，而coverage的.coverage文件可能缓存在那儿，加COVERAGE_FILE=.coverage环境变量强制落盘
CI 测试最麻烦的从来不是语法或逻辑，而是那些“只在别人机器上发生”的路径、权限、并发和环境漂移问题——它们不会报错，只会让覆盖率掉点、测试偶尔挂、或者日志里突然多一行 ResourceWarning: unclosed file。
