运行数月的SQLAlchemy代码突发autoload参数TypeError报错求助

报错原因 #

你遇到的错误是因为SQLAlchemy版本升级到了2.0及以上，该版本彻底移除了autoload=True参数，要求反射表时仅使用autoload_with指定引擎，不需要额外传递autoload=True。之前代码能正常运行，是因为之前使用的是SQLAlchemy 1.4及以下版本——1.4版本虽已标记该参数为废弃，但仍兼容旧写法；若近期依赖自动升级（比如未固定版本号执行pip install），就会触发这个报错。

解决方案 #

方案1：适配SQLAlchemy 2.0+（推荐） #

直接修改代码，移除autoload=True参数，仅保留autoload_with=engine：

connection = engine.connect()
metadata = db.MetaData()
segment_metrics_table = db.Table('analysis', metadata, autoload_with=engine)

方案2：降级SQLAlchemy到1.4.x版本 #

如果需要保留旧代码结构，可以通过pip降级到1.4系列的稳定版本，例如：

pip install sqlalchemy==1.4.49

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