integrityerror外键冲突是数据库拒绝非法引用，因外键值在父表中不存在；需先查删孤立数据、开启sqlite的pragma foreign_keys、确保mysql被引用列有索引且类型匹配。
IntegrityError 外键冲突不是代码写错了，而是数据库在拦你——你正试图插入/更新一条记录，它的外键值（比如 user_id）在被引用的表里根本不存在。
查不到父记录？先确认外键字段是否真有对应主键
错误常出现在手动构造数据、测试脚本或迁移后残留脏数据时。例如：MyModel.objects.create(user_id=999)，但 User 表里已没有 ID 为 999 的记录。
- 别急着改
on_delete或加异常捕获，先查数据库：用原始 SQL 或 ORM 找出孤立记录 -
filter(user__isnull=True)不可靠——因为字段非空但值无效，得用子查询比对 - SQLite 不开
PRAGMA foreign_keys = ON时，约束根本不生效，查也查不出问题（见下条）
SQLite 中外键不报错？必须手动开启 PRAGMA
SQLAlchemy 默认不启用 SQLite 的外键检查，即使模型定义了 ForeignKey，插入非法值也不会抛 IntegrityError。
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- SQLAlchemy 2.0+ 必须用事件监听器，在连接建立时执行：
PRAGMA foreign_keys=ON - 写法是：
@event.listens_for(Engine, "connect")+cursor.execute("PRAGMA foreign_keys=ON") - 旧版用
PoolListener已失效；只设connect_args={"check_same_thread": False}不起作用 - 没开这个 pragma，
INSERT成功但数据逻辑断裂，后续查询可能静默失败
MySQL 报 1452 或 1215？重点看三件事
这类错误往往不是数据问题，而是建表或引擎配置层面卡住了。
-
1452 Cannot add or update a child row：说明子表某条记录的外键值（如role_id=1）在父表role中查无此 ID —— 先插父记录再插子记录，或确保role_id值合法 -
1215 Cannot add foreign key constraint：建表阶段失败，常见于被引用列没索引、类型不匹配（如VARCHAR(20)vsVARCHAR(32)）、字符集不一致（utf8mb4vsutf8） - MySQL 引擎必须是
InnoDB；MyISAM不支持外键，但错误提示反而更模糊 - 被引用列（如
role.id）必须有索引（主键自动带索引，但普通字段需显式加Index）
删表或清库失败报 1217？外键依赖顺序乱了
Base.metadata.drop_all(engine) 失败，通常是因为 SQLAlchemy 不知道哪些表存在外键依赖关系。
- 原因可能是：数据库里有未映射的表（比如手工建的），它外键指向你的
User表，但 SQLAlchemy 不认识它 - 或模型里漏写了
ForeignKey定义，导致 SQLAlchemy 无法推导删除顺序 - 临时解法：手动按依赖逆序删表（先删子表，再删父表），或用
SET FOREIGN_KEY_CHECKS = 0关闭检查（仅限开发环境） - 长期方案：确保所有外键都在模型中明确定义，并用
db.ForeignKeyConstraint显式声明复合外键
最易被忽略的一点：外键约束是数据库层行为，ORM 层的 on_delete 或 cascade 对 INSERT/UPDATE 时的约束检查完全无效——它只管“父记录被删时子记录怎么处理”，不拦你插一个根本不存在的 ID。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
