关键在于环境可复现与步骤可验证;必须用tox覆盖Python 3.10–3.14+Django 4.2–6.0组合,配合显式DJANGO_SETTINGS_MODULE重置、--recreate重建、:memory:测试数据库,并补全系统依赖、staticfiles目录及migrate超时控制。

能自动化测试和部署 Django 项目,关键不在“用什么工具”,而在“环境是否可复现、步骤是否可验证”。流水线跑通不等于交付可靠,真正卡住人的永远是 Python 版本、Django 版本、数据库驱动、静态文件路径这四类隐性依赖。
为什么 pytest-django 必须配合 tox 才算真 CI
只在 CI 中跑 pytest 是假自动化——它默认复用当前 Python 环境,根本无法暴露版本兼容问题。真实项目必须覆盖至少 Python 3.10–3.14 + Django 4.2–6.0 的组合,否则上线后遇到 django.core.exceptions.AppRegistryNotReady 或 ImportError: cannot import name 'AsyncConsumer' 就只能靠猜。
-
tox.ini里必须显式声明矩阵,比如py312-dj52-postgres表示 Python 3.12 + Django 5.2 + PostgreSQL 驱动 - 每个
[testenv]要重置DJANGO_SETTINGS_MODULE,避免继承 CI runner 的全局配置 - CI 中禁用
pip install -e .,改用tox --recreate,强制每次从干净虚拟环境重建 - 如果用 SQLite 测试,
TEST_NAME必须设为:memory:,否则并发 job 会抢同一个文件锁
gitlab-ci.yml 里最常漏掉的三件事
很多团队的 .gitlab-ci.yml 能跑通测试,但一到部署就失败,问题基本出在这三个地方:
- 没提前
apt-get install -y libpq-dev gcc—— 缺系统级依赖会导致psycopg2编译失败,报错信息藏在 pip 日志末尾,容易被忽略 - 静态文件收集前没
mkdir -p $CI_PROJECT_DIR/staticfiles——collectstatic默认写入STATIC_ROOT,但 CI 环境里该目录往往不存在,导致 Nginx 404 - 数据库迁移命令没加
--noinput和超时控制 ——python manage.py migrate在无交互环境下会卡住,且没设 timeout 时,job 可能跑满 1 小时才被 GitLab 杀掉
部署阶段用 Docker 还是直接 SSH?看这三点
直接 SSH 更新代码适合小项目,但一旦涉及多服务或回滚需求,就必须切 Docker。判断依据很实际:
- 如果
settings.py里敏感配置(如密钥、数据库 URL)全靠环境变量注入,Docker 更安全 —— 容器启动时才注入,不会残留进镜像层 - 如果线上用 Gunicorn + Nginx 架构,且 Nginx 配置随项目版本变化(比如新版本加了 CORS 头),必须打包进镜像,否则 SSH 部署后要手动 reload Nginx
- 如果团队没有统一的服务器管理权限,Docker 镜像推到 Harbor 后,运维只需执行
docker run -d --env-file .env ...,不用碰代码或 Python 环境
真正难的不是写完流水线,而是让 tox 矩阵里的每一个组合都稳定通过,以及确保 collectstatic 输出的路径和 Nginx location /static/ 指向完全一致。这两个点不盯死,自动化就是个幻觉。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











