SqlAlchemy 1.4迁移：关联表查询自定义类型断言None值问题

• 核对关联查询的连接类型
  旧查询仅查询SomeOtherModel，未关联其他模型；新查询用join(SomeModel)默认是内连接，只有当两个模型存在匹配关联行时才会返回结果。如果业务需要保留所有SomeOtherModel的记录（即使没有对应的SomeModel），必须改用outerjoin(SomeModel)，否则无匹配的SomeModel列会返回None，触发自定义类型的断言。
• 确认自定义类型对应列的归属
  如果SomeSpecialType对应的列属于SomeModel，当内连接无匹配行时，该列值必然为None。此时要么调整连接类型，要么修改process_result_value中的断言逻辑，允许合法的空值场景。
• 适配查询返回的结构变化
  旧查询SomeOtherModel.query.first()返回单个模型实例；新查询select(SomeOtherModel, SomeModel)...返回的是元组（包含两个模型实例）。如果后续代码仍按单个实例处理，会导致数据解析错误，需调整接收逻辑：

  # 仅需查询SomeOtherModel时，无需关联
  created_other_model = session.execute(select(SomeOtherModel)).scalar_one_or_none()
  # 需关联数据时，正确接收元组
  other_model, some_model = session.execute(select(SomeOtherModel, SomeModel).join(SomeModel)).first()
  

• 显式指定关联条件
  SQLAlchemy 2.0自动匹配外键关联时，若模型间存在多个外键，可能出现匹配错误。显式指定关联条件可避免歧义：

  stmt = select(SomeOtherModel, SomeModel).join(SomeModel, SomeOtherModel.some_fk == SomeModel.id)
  

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