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

若有未应用迁移，先在开发库中执行：

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 管理，日常开发中应避免。

✅ 最佳实践总结

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

# python  # go  # app  # django 

相关栏目： 【 Google疑问12 】 【 Facebook疑问10 】 【 网络优化76771 】 【 技术知识130152 】 【 IDC云计算60162 】 【 营销推广131313 】 【 AI优化88182 】 【 百度推广37138 】 【 网站推荐60173 】 【 精选阅读31334 】

相关推荐： Windows如何使用BitLocker To Go加密U盘？（移动驱动器加密）  php文件怎么变mp4保存_php输出视频流保存为mp4操作【操作】  Win10怎样安装Word样式库_Win10安装Word样式教程【步骤】  Win11笔记本怎么看电池健康度_Win11电池报告生成命令【详解】  Win10如何优化内存使用_Win10内存优化技巧【攻略】  mac本地php环境如何开启curl_curl扩展启用与测试步骤详解【汇总】  Python装饰器设计思路_功能增强机制说明【指导】  Win11怎么制作U盘启动盘_Win11原版系统安装盘制作【详解】  Mac如何使用听写功能_Mac语音输入打字【效率技巧】  Python对象比较与排序_魔术方法解析【教程】  Win11如何卸载OneDrive_Win11卸载OneDrive方法【教程】  Python并发安全问题_资源竞争说明【指导】  如何在Golang中写入XML文件_生成符合规范的XML数据  如何在Golang中捕获HTTP服务器错误_GolangHTTP Handler中error处理  c++ reinterpret_cast怎么用 c++最危险的类型转换【详解】  Win11怎么关闭SmartScreen_禁用Windows Defender筛选器教程【步骤】  Win11怎么关闭小组件_Win11禁用任务栏天气与小组件方法【设置】  Win10怎么卸载迅雷_Win10彻底卸载迅雷方法【步骤】  Windows10如何更改日期格式_Win10区域设置短日期修改  Win10任务栏天气和资讯怎么关闭 Win10禁用新闻和兴趣功能【教程】  Windows蓝屏错误0x00000023怎么修复_FAT文件系统错误处理  如何使用Golang实现负载均衡_分发请求到多个服务节点  mac怎么安装pip_MAC Python pip安装工具与升级方法【详解】  如何在 Go 开发中正确处理本地包导入与远程模块路径的一致性问题  Win11怎么开启游戏模式_Windows11优化游戏帧数设置指南  Windows资源管理器总是卡顿或重启怎么办？（修复方法）  Win11怎么查看已连接wifi密码 Win11查已连wifi密码步骤【教程】  Go 中的 := 运算符：类型推导机制与使用边界详解  Win11文件扩展名怎么显示 Win11查看文件后缀名设置【步骤】  Win11怎么更改管理员名字 Win11修改账户名称详细步骤【教程】  php打包exe后无法读取环境变量_变量配置方法【教程】  php打包exe怎么传递参数_命令行参数接收方法【解答】  Mac怎么开启“任何来源”_Mac安装未签名应用的设置方法【解决】  windows 10应用商店区域怎么改_windows 10微软商店切换地区方法  Win10怎么卸载鲁大师_Win10彻底卸载鲁大师方法【步骤】  Python深度学习实战教程_神经网络模型构建与训练  Win11怎么设置鼠标宏_Win11鼠标按键自定义编程教程【详解】  如何使用Golang实现微服务事件驱动_使用消息总线解耦服务  Win11怎么设置默认视频播放器_Windows 11关联媒体文件打开方式【步骤】  Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】  PHP的FastAdmin架构适合二次开发吗_特点分析【介绍】  Win11蓝牙开关不见了怎么办_Win11蓝牙驱动丢失修复教程【方法】  Win11如何设置系统声音_Win11系统声音调整教程【攻略】  c++怎么使用std::filesystem遍历文件夹_c++ 递归查找文件与权限修改【技巧】  Windows怎样关闭锁屏广告_Windows关闭锁屏广告方法【教程】  Windows10如何更改盘符名称_Win10重命名硬盘分区卷标  C++中的constexpr和const有什么区别？（编译期常量）  Windows10如何更改桌面图标间距_Win10注册表WindowMetrics修改  MySQL 中使用 IF 和 CASE 实现查询字段的条件转换  Win11怎么设置组合键快捷方式_Windows11自定义快捷键操作 

 2026-01-01