SQLAlchemy 2.0 弃用警告及连接关闭问题解决指南

第一段引用上面的摘要 本文旨在帮助 SQLAlchemy 初学者解决在使用 create_engine 时遇到的 “RemovedIn20Warning” 警告，以及随之而来的 “ResourceClosedError” 连接关闭错误。文章将详细解释该警告的原因，并提供消除警告以及修复连接问题的具体步骤和代码示例，确保你能够顺利地查询和操作数据库。

SQLAlchemy 2.0 弃用警告

在使用 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。这个参数已经被弃用，并在未来的版本中将会被移除。

解决方案：

消除这个警告非常简单，只需要移除 future=True 参数即可：

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

虽然这个警告只是提示性的，并不会直接导致程序崩溃，但最好还是按照建议进行修改，以避免未来的兼容性问题。

连接关闭错误 (ResourceClosedError)

除了弃用警告，你可能还会遇到如下错误：

sqlalchemy.exc.ResourceClosedError: This Connection is closed

这个错误表明你在尝试使用一个已经关闭的数据库连接。在 SQLAlchemy 中，通常使用 with 语句来管理数据库连接，以确保连接在使用完毕后能够正确关闭。

常见原因：

这个错误最常见的原因是代码缩进错误，导致在 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)  # 错误：connection 已经关闭 for result in results:     print(result)

解决方案：

确保所有需要在连接中执行的操作都位于 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)  # 正确：connection 在 with 块内     for result in results:         print(result)

总结：

1. 移除 create_engine 函数中的 future=True 参数，消除 SQLAlchemy 2.0 弃用警告。
2. 检查代码缩进，确保所有数据库操作都在 with db.connect() as connection: 语句块内部。

通过遵循这些步骤，你就可以解决 SQLAlchemy 中常见的警告和错误，并编写出更加健壮和易于维护的代码。记住，良好的代码习惯和对 SQLAlchemy 机制的理解是避免这些问题的关键。