升级Pandas至2.2.3后gpd.from_postgis传参报错求助

问题根源 #

不是Pandas的.bindparams本身有问题，而是版本兼容性冲突：

• Pandas 2.2.x对read_sql接口的查询对象处理逻辑做了调整，而你使用的geopandas 1.0.1版本发布于2023年1月，未适配Pandas 2.2.x的新逻辑。当from_postgis内部调用Pandas的read_sql时，无法正确识别带绑定参数的SQLAlchemy text对象，从而抛出"Query must be a string unless using sqlalchemy."错误。

解决方案 #

方案1：升级geopandas（推荐） #

将geopandas升级到0.14.0及以上版本（更高版本如1.4.x更稳妥），新版geopandas已修复与Pandas 2.2.x的SQL查询交互问题，升级后原代码可正常运行。

方案2：临时兼容（不升级依赖时） #

如果暂时无法升级geopandas，可通过以下两种方式绕过问题：

方式A：编译SQLAlchemy查询为字符串

将带绑定参数的text对象编译为包含实际参数的SQL字符串（注意：仅适用于非敏感参数，避免SQL注入风险）：

from sqlalchemy import text
import geopandas as gpd
import pandas as pd

# 定义带参数的查询
query = text("SELECT * FROM your_table WHERE geom IS NOT NULL AND id = :target_id").bindparams(target_id=123)

# 编译查询（需要传入数据库引擎）
compiled_query = query.compile(engine, compile_kwargs={"literal_binds": True})

# 读取数据
gdf = gpd.read_postgis(str(compiled_query), con=engine, geom_col="geom")

方式B：手动执行查询再转GeoDataFrame

先通过SQLAlchemy引擎执行查询获取结果，再转换为GeoDataFrame：

from sqlalchemy import text
import geopandas as gpd
import pandas as pd

query = text("SELECT * FROM your_table WHERE geom IS NOT NULL AND id = :target_id").bindparams(target_id=123)

with engine.connect() as conn:
    # 执行查询
    result = conn.execute(query)
    # 转换为普通DataFrame
    df = pd.DataFrame(result.fetchall(), columns=result.keys())
    # 转换为GeoDataFrame
    gdf = gpd.GeoDataFrame(df, geometry="geom")

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