使用SQLAlchemy Automap添加自定义表后出现'object has no attribute '_sa_instance_state''错误的排查与解决

看起来你遇到的问题核心是自定义的MissingApl类没有被SQLAlchemy的ORM系统正确映射，导致Session无法识别它是一个ORM实例。咱们一步步拆解原因和解决办法：

问题原因 #

你当前的代码顺序存在关键问题：

1. 你先调用了Base.prepare(autoload_with=engine_remote)，这个方法会触发Automap反射远程MSSQL的表结构，同时完成Base类的映射初始化流程。
2. 之后才定义MissingApl类继承自Base。这时候SQLAlchemy已经完成了Base的映射注册，后续新增的类不会被自动纳入ORM映射体系，所以当你尝试把MissingApl实例加入Session时，就会抛出"未映射实例"的错误。

解决办法 #

调整代码顺序，把自定义类的定义放到Base.prepare()之前，让ORM系统在初始化时就能识别到这个自定义表：

1. 重新组织代码结构 #

# 先创建Automap Base
Base = automap_base()

# 优先定义自定义表类
class MissingApl(Base):
    __tablename__ = "missing_apl"
    id: Mapped[int] = Column(Integer, primary_key=True)
    appln_nr: Mapped[int] = Column(Integer)

# 定义列类型转换的监听函数（保持原有逻辑不变）
@event.listens_for(Base.metadata, "column_reflect")
def genericize_datatypes(inspector, tablename, column_dict):
    old_type = column_dict['type']
    column_dict["type"] = column_dict["type"].as_generic()
    if getattr(column_dict["type"], "collation", None) is not None:
        column_dict["type"].collation = None

# 再执行Base的prepare，反射远程表结构
Base.prepare(autoload_with=engine_remote)

# 最后创建本地数据库的所有表（包括自定义的missing_apl）
Base.metadata.create_all(engine_local)

2. 验证修复效果 #

现在再运行你的测试代码：

testobj=MissingApl(appln_nr=9999)
print(testobj)
with Session(engine_local) as session:
    session.add(testobj)
    session.commit()

此时MissingApl类已经被正确纳入ORM映射体系，Session可以正常识别并处理它的实例，不会再抛出_sa_instance_state相关的错误。

补充说明 #

• Automap的核心是反射现有数据库表生成ORM类，如果你需要添加自定义表，必须让这些自定义类在Base.prepare()之前就存在，这样Automap才能把它们纳入元数据管理。
• 确保你已经正确导入了所需的模块：from sqlalchemy.orm import Mapped, Session、from sqlalchemy import Column, Integer等，缺失导入也可能导致隐性问题。

备注：内容来源于stack exchange，提问作者robertspierre