Pandas 2.0+ 要求 SQLAlchemy ≥1.4.16，而当前环境使用 SQLAlchemy 1.3.18 导致 pd.read_sql() 调用失败（AttributeError: 'Connection' object has no attribute 'exec_driver_sql'），需统一升级 SQLAlchemy 版本以恢复数据库查询功能。
pandas 2.0+ 要求 sqlalchemy ≥1.4.16，而当前环境使用 sqlalchemy 1.3.18 导致 `pd.read_sql()` 调用失败（`attributeerror: 'connection' object has no attribute 'exec_driver_sql'`），需统一升级 sqlalchemy 版本以恢复数据库查询功能。
该错误源于 Pandas 2.0.3 与 SQLAlchemy 1.3.18 的版本不兼容。自 Pandas 2.0 起，pd.read_sql() 内部改用 SQLAlchemy 1.4+ 新增的 Connection.exec_driver_sql() 方法执行原始 SQL 查询；而 SQLAlchemy 1.3.x 中仅提供 execute() 方法，且其签名和行为与新版不一致，因此触发 AttributeError。
✅ 正确解决方式（推荐）
升级 SQLAlchemy 至 1.4.16 或更高版本（兼容 Pandas 2.0.x）：
pip install --upgrade "sqlalchemy>=1.4.16,<2.0"
✅ 验证安装：
import sqlalchemy print(sqlalchemy.__version__) # 应输出如 '1.4.49' 或 '2.0.30'
同时确保其他依赖无冲突（如 pyodbc, pymysql 等驱动版本仍兼容）。Pandas 官方 安装文档 明确列出：Pandas 2.0.x 最低要求 SQLAlchemy 1.4.16。
⚠️ 不推荐的替代方案
- ❌ 降级 Pandas 至 1.3.x（如
pip install pandas==1.3.5）：虽可绕过报错，但将失去 Pandas 2.0 的性能优化、新 API（如dtype_backend="pyarrow"）、安全修复及长期维护支持，且易引发其他第三方库兼容问题。 - ❌ 手动 patch
pd.read_sql：违反封装原则，不可维护，且可能破坏事务一致性。
? 代码适配建议（增强健壮性）
即使版本修复后，也建议优化原函数中的潜在风险点：
def request_pickup(connections, request_id):
env_path = connections.loc[0, 'm_drive']
hip_directory = connections.loc[0, 'hip_directory']
sys.path.append(env_path + '/global_info')
from py_variables import sqlalchemy_cnx_string, ssl_args
# ✅ 使用 engine.connect() 显式管理连接生命周期（更安全）
engine = sqlalchemy.create_engine(sqlalchemy_cnx_string, connect_args=ssl_args)
pickup_info_query = """
SELECT fld40 AS record_id, fld3 AS client_name
FROM rmf_tb.rfsocatalogrh
WHERE fld40 = %s -- ✅ 使用参数化查询，防止 SQL 注入
"""
try:
with engine.connect() as conn:
pickup_info = pd.read_sql(pickup_info_query, conn, params=[request_id])
if len(pickup_info) != 1:
raise ValueError(f"Expected exactly 1 pickup record for ID {request_id}, got {len(pickup_info)}")
return pickup_info.iloc[0] # 返回 Series 更符合语义
except Exception as e:
raise RuntimeError(f"Failed to fetch pickup info: {e}") from e? 总结
- 根本原因：Pandas 2.0+ 强依赖 SQLAlchemy 1.4+ 的
exec_driver_sql接口； - 唯一可持续方案：将 SQLAlchemy 升级至 ≥1.4.16（推荐 1.4.49 或 2.0.x LTS 版本）；
- 同步建议：使用参数化查询、显式连接上下文管理、结构化异常处理，提升生产环境稳定性。
