讲师中心 微信公众号
AI工具推荐 视频效率加速

为什么Python Django迁移文件(Migrations)会导致生产环境锁表?

雨宇姑娘_4648

雨宇姑娘_4648

发布时间:2026-08-29 08:12:30

|

374人浏览过

|

来源于php中文网

原创

Django的migrate命令本身不锁表,锁表源于底层数据库执行ALTER TABLE等DDL语句时的固有行为;PostgreSQL 11+对无默认值ADD COLUMN支持并发,但带DEFAULT仍需重写表,MySQL多数ALTER触发copy-alter流程导致锁表。

为什么python django迁移文件(migrations)会导致生产环境锁表?

migrate 命令在生产环境锁表,不是 Django 故意设计的“功能”,而是底层数据库(如 PostgreSQL、MySQL)执行 DDL 操作时的自然行为——多数 ALTER TABLE 操作会阻塞读写,尤其在大表上持续数秒甚至数分钟。

这背后没有魔法,只有 SQL 和事务隔离级别的现实约束。下面说清楚怎么做、为什么、以及最容易翻车的地方。

ALTER TABLE 在 PostgreSQL/MySQL 中天然锁表

当你加字段、改类型、设默认值时,Django 生成的迁移最终会调用类似 ALTER TABLE users ADD COLUMN is_active BOOLEAN DEFAULT TRUE 的语句。这类操作在:

  • PostgreSQL 11+ 对 ADD COLUMN 且无默认值或默认为 NULL 的情况支持并发(不锁写),但带 DEFAULT 或 NOT NULL 仍需全表扫描并重写数据页
  • MySQL(InnoDB)几乎所有 ALTER TABLE 都触发“copy-alter”流程:建新表 → 拷贝数据 → 重命名,期间原表只读或完全锁定(取决于版本和 ALGORITHM 参数)
  • SQLite 直接串行化所有写操作,锁表现象更明显

所以不是 Django 锁表,是它生成的 SQL 让数据库锁了。

立即学习“Python免费学习笔记(深入)”;

migrate 不会自动拆分或后台执行 DDL

Django 的 migrate 是同步阻塞命令,它:

Claw Code Suite (Python-Only Edition)
Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成,提供 184 种工具和 200 多条命令,用于安全分析和代码质量...

下载
  • 按顺序执行每个迁移文件中的 Operation
  • 每个 Operation 转成一条或多条 SQL,在一个事务里提交(部分数据库不支持 DDL 在事务中)
  • 不做在线 DDL 封装,也不调用 pt-online-schema-change 或 pg_repack 这类工具

也就是说,你跑 python manage.py migrate,就等于手动在 psql 或 mysql client 里敲那几条 ALTER,没有任何缓冲或降级策略。

如何避免锁表?关键在迁移写法和执行时机

真正能缓解锁表的,不是换命令,而是改写法 + 控制执行节奏:

  • 加字段优先用 null=True,避免 default=...;后续再用数据迁移填值(RunPython)
  • 修改字段类型前,先新增兼容字段 → 同步双写 → 迁移旧数据 → 删除旧字段,而不是直接 AlterField
  • 对大表(>100万行),把单个迁移拆成多个小迁移:比如先 AddField,再 RunSQL 批量更新,最后 AlterField 改约束
  • 在低峰期执行,并配合数据库侧的在线 DDL 工具:MySQL 可加 ALGORITHM=INPLACE, LOCK=NONE(需 5.6+),PostgreSQL 可用 CONCURRENTLY 创建索引(但不适用于 ALTER COLUMN)

注意:--fake 或 --fake-initial 不解决锁表问题,它们跳过 SQL 执行,只更新 django_migrations 表——适合修复迁移状态错乱,但不能绕过真实 DDL。

生产环境迁移失败后残留锁怎么查?

锁本身不会“残留”,但迁移中断可能导致:

  • 未提交的长事务(PostgreSQL 中 SELECT * FROM pg_stat_activity WHERE state = 'idle in transaction')
  • MySQL 中被 kill 掉但未回滚完的 ALTER(查 SHOW PROCESSLIST 看 State 是否卡在 copy to tmp table)
  • django_migrations 表记录不全,导致下次 migrate 重复尝试已部分执行的迁移

此时不要删迁移文件硬重来。先确认数据库是否真有锁,再决定是手动清理事务、补 fake 记录,还是用 sqlmigrate 提取 SQL 单独执行并监控。

真正麻烦的从来不是“怎么跑迁移”,而是“哪条 SQL 会锁、锁多久、有没有替代路径”。DDL 没有银弹,只有权衡。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

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

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

1751

2023.07.20

python能做什么
python能做什么

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

4524

2023.07.25

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

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

1729

2023.07.31

python教程
python教程

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

26657

2023.08.03

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

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

3227

2023.08.04

python eval
python eval

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

3247

2023.08.04

scratch和python区别
scratch和python区别

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

1183

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn