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 类迁移导致依赖混乱。

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

云从科技AI开放平台
云从科技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 等缺失字段问题将彻底解决,且测试具备完全的隔离性与可靠性。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

166

2026.02.04

default gateway怎么配置
default gateway怎么配置

配置default gateway的步骤:1、了解网络环境;2、获取路由器IP地址;3、登录路由器管理界面;4、找到并配置WAN口设置;5、配置默认网关;6、保存设置并退出;7、检查网络连接是否正常。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

236

2023.12.07

discuz database error怎么解决
discuz database error怎么解决

discuz database error的解决办法有:1、检查数据库配置;2、确保数据库服务器正在运行;3、检查数据库表状态;4、备份数据;5、清理缓存;6、重新安装Discuz;7、检查服务器资源;8、联系Discuz官方支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

227

2023.11.20

postgresql常用命令
postgresql常用命令

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、l、c、dt、d table_name、du、i file_name、e和q等。本专题为大家提供postgresql相关的文章、下载、课程内容,供大家免费下载体验。

164

2023.10.10

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1007

2023.11.02

postgresql常用命令有哪些
postgresql常用命令有哪些

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、l、c、dt、d table_name、du、i file_name、e和q等。更详细的postgresql常用命令,大家可以访问下面的文章。

214

2023.11.16

postgresql常用命令介绍
postgresql常用命令介绍

postgresql常用命令有l、d、d5、di、ds、dv、df、dn、db、dg、dp、c、pset、show search_path、ALTER TABLE、INSERT INTO、UPDATE、DELETE FROM、SELECT等。想了解更多postgresql的相关内容,可以阅读本专题下面的文章。

280

2023.11.20

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

229

2026.02.12

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

1

2026.03.13

热门下载

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

精品课程

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

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

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