Flask中需按数据库驱动识别死锁异常并用装饰器封装重试逻辑:PostgreSQL用psycopg2.OperationalError且pgcode=='40P01',MySQL检查pymysql.err.OperationalError.args[0]==1213;重试限3次、指数退避、仅针对死锁;事务须整体重放,重试前清空session;日志需记录SQL、参数、堆栈,暴露/health/db-deadlocks端点监控重试率。

Flask中捕获并识别数据库死锁异常
Flask本身不处理数据库死锁,关键在底层ORM或DB-API驱动抛出的异常类型。不同数据库驱动报的死锁错误名不一致,必须按实际驱动确认:psycopg2(PostgreSQL)抛psycopg2.OperationalError且err.pgcode == '40P01';pymysql(MySQL)在pymysql.err.OperationalError中检查args[0] == 1213;SQLite则基本不触发标准死锁(因WAL模式下无行级锁竞争)。别直接捕获Exception——会吞掉真正该崩的错误。
用装饰器封装重试逻辑,避免业务代码污染
把重试逻辑从视图函数里抽出来,用函数装饰器最干净。核心是控制重试次数、间隔和回退策略:
- 重试次数建议设为3次,再高大概率是设计问题而非瞬时冲突
- 每次重试前加指数退避:
time.sleep(0.1 * (2 ** attempt)),避免雪崩式重试 - 仅对明确标记为死锁的异常重试,其他
OperationalError(如连接断开)不重试 - 装饰器需支持同步/异步视图函数,Flask 2.0+ 推荐用
functools.wraps保持原函数签名
示例片段:
@retry_on_deadlock(max_attempts=3)
def create_order(user_id, items):
# DB写操作
db.session.add(Order(user_id=user_id, items=items))
db.session.commit()
SQLAlchemy事务边界必须显式控制
很多人以为db.session.commit()自动包裹整个请求,其实不是。死锁发生在commit()时,但若前面已有add()/query(),session已持锁。重试时必须确保整个事务原子重放:
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
立即学习“Python免费学习笔记(深入)”;
- 不能只重试
commit(),要重试整个业务逻辑块(含查询、计算、插入) - 避免在重试函数内调用
db.session.rollback()后不清空session——残留的Pending对象会导致下次commit重复插入 - 重试前务必调用
db.session.expunge_all()或新建session实例(更安全) - 若用Flask-SQLAlchemy,注意
scoped_session在重试时可能复用旧session,需手动remove()
日志与监控不能只记“重试成功”
死锁重试不是静默修复,而是系统压力信号。光打INFO日志没用:
- 每次重试必须记录原始SQL、参数、堆栈、重试序号,方便定位哪条语句高频冲突
- 暴露一个
/health/db-deadlocks端点,返回最近1小时死锁次数,接入Prometheus - 对重试失败的请求,必须返回
503 Service Unavailable而非500,让上游知道是暂时性过载 - 警惕“重试掩盖了索引缺失”——比如两个事务按不同顺序更新
user和order表,加联合索引或统一更新顺序才是根治
死锁重试容易让人误以为问题已解决,其实它只是把并发瓶颈从崩溃转成了延迟。真正要盯的是重试率突增的那几类请求,而不是让装饰器跑得更稳。

















