Django 信号避坑为什么 post_save 里读不到最新数据前几天帮同事排查了一个典型的 Django 生产 bug他在模型的post_save信号中调用了异步队列任务但队列执行时永远读取到旧数据和当前更新的版本完全对不上。这个问题看似诡异实则是 Django 信号 事务机制的经典陷阱今天把排查思路和解决方案整理出来帮大家避开这个坑。问题排查初步分析问题根源可能源于以下两方面1. 信号重复触发/并发覆盖多个信号重复执行导致后执行的逻辑覆盖了最新数据读到旧值。但同事的代码是全新编写无冗余逻辑简单测试后直接排除。2. 事务隔离导致的“数据不可见”这是核心问题——接口逻辑顶层包裹了transaction.atomic事务装饰器。我最初忽略了顶层父类的事务装饰器误以为post_save是「事务提交后」触发反复验证第一种原因浪费了不少时间。最终逐层追溯代码定位到顶层事务确认是事务未提交 信号执行时机不匹配导致的问题。核心原理关键很多人会踩坑的点Django 的post_save信号不是在事务提交后触发而是在模型执行 INSERT/UPDATE 语句后、事务提交前触发。如果你的接口/业务逻辑顶层加了transaction.atomic整个流程会是这样模型修改 → 触发post_save信号 → 信号调用异步队列整个事务未执行完成提交前数据库不会持久化最新数据异步队列是独立线程/进程会开启新事务自然读取不到未提交的最新数据这就是「信号里写了更新队列却读旧数据」的根本原因。解决方案使用 Django 事务提交钩子Django 专门提供了事务提交后执行的钩子transaction.on_commit()它能保证只有当前事务成功提交后才会执行包裹的逻辑完美解决数据不可见问题。代码修改示例❌ 错误写法post_save 直接调用fromdjango.db.models.signalsimportpost_savefromdjango.dispatchimportreceiverfrommyapp.modelsimportMyModelfrommyapp.tasksimportasync_queue_taskreceiver(post_save,senderMyModel)defhandle_model_save(sender,instance,**kwargs):# 事务未提交异步任务读不到最新数据async_queue_task.delay(instance.id)✅ 正确写法on_commit 包裹fromdjango.dbimporttransactionfromdjango.db.models.signalsimportpost_savefromdjango.dispatchimportreceiverfrommyapp.modelsimportMyModelfrommyapp.tasksimportasync_queue_taskreceiver(post_save,senderMyModel)defhandle_model_save(sender,instance,**kwargs):# 等待事务提交后再执行异步任务transaction.on_commit(lambda:async_queue_task.delay(instance.id))总结整理3个关键要点帮大家彻底避开这个坑不要默认post_save是提交后触发它执行在「SQL执行后、事务提交前」。只要代码用了transaction.atomic信号里的异步/跨线程操作必须用on_commit。最佳实践Django 信号中需要操作最新数据库数据的逻辑统一用transaction.on_commit()包裹从根源避免事务隔离导致的脏数据/旧数据问题。补充一句不只是post_saveDjango 中所有事务内的异步操作都要依赖on_commit保证数据一致性哦~