SQLAlchemy 2.0 弃用警告及连接关闭错误排查与解决

第一段引用上面的摘要： 本文旨在帮助 SQLAlchemy 初学者解决在使用 create_engine 时遇到的 “RemovedIn20Warning” 警告以及后续出现的 “This Connection is closed” 错误。文章将分析警告产生的原因，并提供移除警告的方案，同时深入探讨连接关闭错误的本质，并给出相应的代码修正建议，确保 SQLAlchemy 代码能够正确执行。

SQLAlchemy 2.0 弃用警告：future=True

在使用 SQLAlchemy 时，你可能会遇到如下警告：

RemovedIn20Warning: Deprecated API features detected! These feature(s) are not compatible with SQLAlchemy 2.0.

这个警告通常与 create_engine 函数的 future=True 参数有关。

db = create_engine("postgresql:///chinook", future=True)

虽然 SQLAlchemy 2.0 已经发布，并且所有 Engine 对象默认都是 “future” 风格的引擎，但早期版本为了兼容性，允许显式设置 future=True。 然而，这个参数在后续的 2.x 版本中将被弃用并最终移除。

解决方法：

移除 future=True 参数即可消除警告。

db = create_engine("postgresql:///chinook")

注意： 这个警告仅仅是提示信息，不会直接导致程序崩溃。 但是，遵循最佳实践，移除已弃用的参数有助于代码的长期维护和升级。

连接关闭错误：sqlalchemy.exc.ResourceClosedError: This Connection is closed

在修复警告后，你可能会遇到以下错误：

sqlalchemy.exc.ResourceClosedError: This Connection is closed

这个错误表明你试图在一个已经关闭的数据库连接上执行操作。 在提供的示例代码中，问题通常出在使用 with 语句时，后续的代码没有正确缩进。

问题代码示例：

with db.connect() as connection:      # Query 1 - select all records from the "Artist" table     select_query = artist_table.select()  results = connection.execute(select_query) for result in results:     print(result)

原因分析：

with db.connect() as connection: 语句创建了一个数据库连接，并且在 with 语句块结束时自动关闭连接。 在上面的代码中，results = connection.execute(select_query) 和后续的 for 循环没有包含在 with 语句块中，因此当执行到这些代码时，connection 已经关闭，导致 ResourceClosedError 错误。

解决方法：

确保所有需要在连接上执行的操作都位于 with 语句块内部，即正确缩进代码。

修正后的代码：

with db.connect() as connection:     # Query 1 - select all records from the "Artist" table     select_query = artist_table.select()      results = connection.execute(select_query)     for result in results:         print(result)

总结：

1. RemovedIn20Warning 警告可以通过移除 create_engine 中的 future=True 参数来解决。
2. ResourceClosedError 错误通常是由于在连接关闭后尝试访问连接引起的。 确保所有数据库操作都在 with db.connect() as connection: 语句块内部执行。
3. 良好的代码缩进是避免此类错误的关键。