0

0

Django 测试数据库表缺失与字段未创建问题的完整解决方案

心靈之曲

心靈之曲

发布时间:2026-01-01 18:11:02

|

930人浏览过

|

来源于php中文网

原创

Django 测试数据库表缺失与字段未创建问题的完整解决方案

django 运行 `python manage.py test` 时测试数据库仅创建部分表、缺少关键字段(如 `core_division.display_name`),根本原因通常是迁移文件不一致或未正确应用,而非配置错误。本文将系统性排查并修复该问题。

在 Django 中,测试数据库(test database)默认由 manage.py test 自动创建,并基于当前项目的迁移历史(migrations)重建所有模型对应的表结构——它不复用生产数据库的物理结构,也不执行 syncdb 或跳过迁移。你观察到测试库仅生成 47 张表(远少于实际 226 个模型),且关键字段缺失,这强烈表明:Django 在构建测试数据库时未能识别或应用完整的迁移链

? 根本原因定位

Django 测试流程的关键逻辑是:

  • 创建空测试数据库(如 test_myscore);
  • 逐个执行所有 migrations/ 下的迁移文件(按依赖顺序)
  • 若某模型无迁移文件,或迁移文件未被 makemigrations 生成,其表/字段将完全不会出现在测试库中

你启用 'MIGRATE': False 后表数升至 195 且字段存在,恰恰反向验证了这一点:此时 Django 跳过了迁移步骤,直接复用了已有数据库结构(配合 --keepdb),但因未真正运行迁移,后续 ORM 操作(如 save()、filter())会因 schema 与模型定义不一致而静默失败或报错。

⚠️ 注意:'MIGRATE': False 是危险的临时绕过手段,绝不适用于常规测试——它破坏了测试环境的隔离性与可重现性。

✅ 正确修复步骤(推荐顺序执行)

1. 确保所有应用均含有效迁移目录

检查每个 Django app(如 core/, accounts/)下是否存在 migrations/ 子目录,且其中至少包含一个初始迁移文件(如 0001_initial.py)。若缺失,请手动创建:

mkdir -p core/migrations/
touch core/migrations/__init__.py

2. 生成并验证迁移文件完整性

在项目根目录运行:

python manage.py makemigrations --dry-run --verbosity=2
  • 若输出显示“No changes detected”,说明当前模型与迁移文件一致;
  • 若提示“Create model Division”等新增项,说明有模型变更未迁移 → 执行 python manage.py makemigrations 并提交新迁移文件。

3. 检查迁移依赖关系是否断裂

运行以下命令查看迁移状态:

python manage.py showmigrations

重点关注:

  • 是否存在 [ ](未应用)标记的迁移(尤其在 core app 下);
  • 是否有 !!! 标记(表示迁移文件存在但无对应记录,即“未应用但已删除”);
  • 是否存在 SQUASHED 或 REPLACE 类迁移导致依赖混乱。

若有未应用迁移,先在开发库中执行:

Kacha
Kacha

KaCha是一款革命性的AI写真工具,用AI技术将照片变成杰作!

下载
python manage.py migrate

4. 清理测试残留并重试(关键!)

删除残留测试库(PostgreSQL 中):

-- 连接到 PostgreSQL(如 psql -U your_user)
DROP DATABASE IF EXISTS test_myscore;

然后干净启动测试:

python manage.py test your_app.tests --keepdb  # --keepdb 便于调试,首次建议省略

5. 验证测试数据库结构

若仍失败,在测试崩溃后立即连接测试库(如 psql test_myscore),执行:

\d core_division

确认 display_name 字段是否存在。若不存在,说明 core app 的最新迁移(含该字段)未被加载——请回到第 2 步复查 core/migrations/ 下是否有类似 0012_add_display_name_to_division.py 的文件,并确保其 dependencies 正确指向前序迁移。

? 配置误区澄清

你当前 TEST 配置中的 'SERIALIZE': False 是合理优化(禁用 fixture 序列化提升速度),但以下选项需谨慎:

  • 'MIRROR': 'default':绝对禁止用于真实测试——它让测试直接操作生产库,存在数据污染与安全风险;
  • 'MIGRATE': False:仅限极特殊场景(如测试迁移本身),且必须配合 --keepdb 和手动 schema 管理,日常开发中应避免。

✅ 最佳实践总结

场景 推荐做法
日常单元测试 使用默认配置(无 TEST 覆盖),确保 makemigrations 已提交、migrate 已执行
CI/CD 流水线 添加预检步骤:
python manage.py makemigrations --check --dry-run(失败则阻断构建)
多数据库测试 为非 default 数据库显式指定 --database=other_db,并在 TEST['MIRROR'] 中正确配置镜像关系

通过以上步骤,你的测试数据库将准确反映全部 226 个模型及所有字段,core_division.display_name 等缺失字段问题将彻底解决,且测试具备完全的隔离性与可靠性。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

716

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

627

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

741

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1236

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

575

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

699

2023.08.11

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

65

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 2.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号