Pytest Fixture返回数据库实例时SQLAlchemy Load事件失效问题

问题背景 #

• 事件监听器逻辑：load事件触发时将字段中的下划线替换为空格；新增/更新事件触发时将空格替换为下划线
• 异常场景：当pytest的spirit fixture返回通过create_spirit存入数据库的Spirit实例时，测试函数中使用该实例的过程里，SQLAlchemy的load事件监听器完全不生效
• 正常场景：fixture返回实例ID、创建Schema对象，或者不使用该fixture时，事件监听器均能正常触发
• 环境版本：fastapi 0.105.0、pytest 8.0.0、sqlalchemy 2.0.23
• 日志佐证：返回实例时无deserialize相关日志，其他正常场景下日志输出正常

可能的原因排查方向 #

• 内存实例未触发数据库加载流程：
  fixture中通过create_spirit创建的实例是直接存在于会话内存中的对象，并没有经过「写入数据库→重新读取」的完整流程。SQLAlchemy的load事件只有在从数据库中读取对象（比如执行查询语句、会话刷新触发的重新加载）时才会触发，直接返回内存实例自然不会触发该事件。
• Fixture会话管理逻辑问题：
  如果fixture创建实例后未提交会话，或直接返回创建后的内存实例而非从数据库重新查询，都会导致load事件缺失——只有实例被持久化到数据库并重新加载时，监听器才会被触发。
• 事件监听器绑定时机滞后：
  若监听器是在fixture创建实例之后才完成绑定，那么已存在的内存实例不会触发后续的load事件，只有绑定后新加载的对象才会生效。

验证与解决思路 #

1. 修改Fixture逻辑，强制触发数据库加载
   不要直接返回创建的内存实例，提交会话后通过主键重新查询返回：

   @pytest.fixture
   def spirit(db_session):
       spirit = create_spirit(db_session, name="test_spirit")
       db_session.commit()
       # 从数据库重新加载实例，触发load事件
       return db_session.query(Spirit).get(spirit.id)
   

2. 检查监听器绑定时机
   确保事件监听器在应用启动或测试初始化阶段就完成绑定，比如在模型定义后立即注册，或在测试conftest.py的初始化代码中完成绑定。

3. 测试时手动触发实例重新加载
   在测试函数中通过会话过期实例，强制从数据库重新读取：

   def test_spirit_load_event(spirit, db_session):
       db_session.expire(spirit)
       # 访问实例属性会触发重新加载，进而触发load事件
       assert spirit.name == "test spirit"
   

内容的提问来源于stack exchange，提问作者usiohc