“database is locked”错误源于SQLite文件锁机制，常见于多进程并发、连接未关闭或WAL残留文件未清理，需终止占用进程并删除.db-wal/.db-shm文件解决。
django.db.utils.OperationalError: database is locked 是 SQLite 的典型卡死信号
SQLite 在多进程或未正确关闭连接时容易锁库，migrate 进程尝试写表但被另一个残留连接占着 db.sqlite3 文件，就会无限等待直到超时或手动中断。常见于开发中反复 Ctrl+C 中断迁移、用 IDE 内置终端跑命令、或同时开多个 Django shell / runserver 实例。
实操建议：
- 关掉所有可能访问数据库的进程：
runserver、shell、Celery worker、甚至某些 IDE 的数据库插件预览功能 - 删掉
db.sqlite3-journal和db.sqlite3-wal（如果存在）——它们是 SQLite 的临时日志文件，残留会导致锁无法释放 - 用
lsof | grep sqlite3（macOS/Linux）或handle.exe db.sqlite3（Windows + Sysinternals）查谁在占用文件 - 换用
python manage.py migrate --fake-initial仅在确认初始迁移已执行但记录丢失时使用，别乱加
PostgreSQL 报错 “could not serialize access due to concurrent update”
这不是卡死，而是事务冲突：Django 迁移默认开启事务，而你本地或测试环境有其他长事务（比如某个没 commit 的 psql 会话、或后台任务正在跑大更新），PG 强一致性机制直接拒绝迁移事务提交。
实操建议：
- 连上数据库执行
SELECT * FROM pg_stat_activity WHERE state = 'active';，找长时间运行的非 idle 连接，用pg_terminate_backend(pid)干掉可疑会话 - 避免在生产或共享测试库上边跑迁移边做数据导入/清洗；迁移前先停掉所有应用实例
- 对超大表加字段等操作，PostgreSQL 12+ 支持
ADD COLUMN ... DEFAULT NULL无锁，但 Django 默认生成的 SQL 可能带默认值——检查sqlmigrate输出：python manage.py sqlmigrate myapp 0001
MySQL 迁移卡在 “Waiting for table metadata lock”
这是 MySQL 的元数据锁（MDL）阻塞，比 InnoDB 行锁更底层。只要有一个慢查询、未提交事务、或客户端断连但连接没回收，就可能让整个表的 DDL（如 ALTER TABLE）挂起。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
实操建议：
- 查锁源：
SELECT * FROM information_schema.PROCESSLIST WHERE COMMAND != 'Sleep';，重点关注State是Waiting for table metadata lock或Locked的行 - 用
KILL [id]干掉对应连接（注意别 KILL 自己的迁移进程） - Django 4.2+ 对 MySQL 增加了
ALTER TABLE ... ALGORITHM=INPLACE支持，但需显式配置：在settings.py加DATABASES['default']['OPTIONS'] = {'init_command': "SET SESSION alter_algorithm='INPLACE'"};（仅限支持版本） - 避免在高峰时段跑迁移；大表变更优先考虑 pt-online-schema-change 工具替代原生命令
自定义迁移里用了 time.sleep() 或 requests.get() 导致假性卡死
迁移代码本该是纯数据库操作，但有人在 RunPython 里调外部 API、读大文件、甚至加 time.sleep(5) 模拟“等部署完成”，结果网络超时或磁盘 IO 拖住整个迁移流程，看起来像卡死。
实操建议：
- 把耗时逻辑全移出迁移：用 management command 替代，或发消息到队列异步处理
-
RunPython函数必须是幂等的，且不能依赖外部状态；若真要等某服务就绪，改用轻量探测（如socket.create_connection((host, port), timeout=2)）而非完整 HTTP 请求 - 调试时加日志：
print("About to fetch data...")，确认卡点是否真在 DB 层还是 Python 层
Django 迁移卡死很少是框架本身问题，绝大多数是数据库状态、并发干扰或迁移代码越界导致的。真正麻烦的是那些不报错、只沉默等待的场景——这时候得盯住数据库层面的活跃会话和锁状态，而不是只翻 Django 日志。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
