如何修复‘ImportError: cannot import name 'string_types' from 'sqlalchemy.util.compat’错误？

错误原因 #

核心问题是snowflake-sqlalchemy 1.4.7版本与SQLAlchemy 1.4.50、Python3.11存在兼容性冲突。string_types是SQLAlchemy 1.3及更早版本的兼容模块，SQLAlchemy 1.4已移除该导入项，但旧版snowflake-sqlalchemy仍在尝试引用它，导致导入失败。

解决方案 #

方案1：升级snowflake-sqlalchemy到兼容版本 #

执行命令升级到适配SQLAlchemy 1.4和Python3.11的版本：

pip install --upgrade snowflake-sqlalchemy>=1.4.8

snowflake-sqlalchemy 1.4.8及以上版本已修复string_types的导入问题，同时适配Python3.11环境。

方案2：锁定经过验证的兼容版本组合 #

如果升级后出现其他依赖问题，可强制安装以下稳定兼容的版本组合：

pip install snowflake-connector-python==3.2.0 snowflake-sqlalchemy==1.4.10 SQLAlchemy==1.4.50

该版本组合已验证可稳定支持Python3.11连接Snowflake。

方案3：解决虚拟环境与全局包的冲突 #

从报错路径看，SQLAlchemy安装在全局Python目录，而snowflake-sqlalchemy在虚拟环境中，可能存在依赖加载优先级冲突。处理步骤：

1. 激活虚拟环境：

xxx\monitoring\envs\Scripts\activate

2. 卸载全局SQLAlchemy（避免干扰虚拟环境）：

pip uninstall -y SQLAlchemy

3. 在虚拟环境内重新安装指定版本依赖：

pip install snowflake-connector-python==3.2.0 snowflake-sqlalchemy==1.4.10 SQLAlchemy==1.4.50

验证方法 #

安装完成后，运行以下测试代码确认连接正常：

from sqlalchemy import create_engine

# 替换为你的Snowflake连接信息
engine = create_engine(
    'snowflake://<user>:<password>@<account>/<database>/<schema>?warehouse=<warehouse>&role=<role>'
)
with engine.connect() as conn:
    result = conn.execute("SELECT CURRENT_VERSION()")
    print(result.fetchone())

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