GIS Python 流程最危险的升级，往往不是主版本，而是被当成“只修 bug”的补丁。因为它可能正好触及数据库写入、随机样本顺序、地图图例或空几何叠加：这些路径平时不一定报警，却会影响审计、可复现结果和下游业务。

GeoPandas v1.1.4 于 2026 年 6 月 26 日发布，官方说明将其列为 bug fixes。该版本的价值不在于新增功能，而在于给团队提供了一份明确的回归清单。

GeoPandas 项目标识GeoPandas 项目标识

可核查事实

  • v1.1.4 进一步加固 to_postgis 以防范 SQL injection。
  • sample_points 生成的点不再错误地沿 x 轴排序。
  • GeoDataFrame.explore 对分类和布尔字段应尊重 legend_kwds={"labels": ...}。
  • overlay 面对空输入时，对 keep_geom_type 的处理更平稳。
  • 官方完整变更比较范围为 v1.1.3...v1.1.4。

核心机制：四个修复对应四类可见后果

to_postgis 处在数据从 Python 写入空间数据库的信任边界。官方加固 SQL injection 不代表任何字符串都可以拼接进 SQL；团队仍应使用受限数据库角色、参数化接口和允许列表。升级验收要覆盖表名、schema、字段名和异常输入，而非只确认一次正常写入。

sample_points 的顺序修复关系到可复现抽样：如果下游把输出顺序当成记录顺序、训练样本索引或审计依据，沿 x 轴排序会造成隐蔽偏差。explore 图例修复则影响交互地图的语义呈现；overlay 的空输入处理关系到批处理遇到无交集、筛选为空时能否稳定交付。

技术路径

  1. 固定 GeoPandas、Shapely、pandas、SQLAlchemy、PostGIS 与 GEOS 版本，先在隔离环境安装 1.1.4。
  2. 用最小测试表验证 to_postgis 正常写入和异常标识符拒绝路径，并使用低权限账号。
  3. 固定随机种子，比较 sample_points 的坐标集合与输出顺序；顺序有业务含义时显式排序。
  4. 为分类和布尔字段生成 explore 地图，核对自定义图例标签与截图。
  5. 对相交、无交集和空 GeoDataFrame 分别运行 overlay，记录 keep_geom_type、要素数、CRS 和几何类型。
  6. 通过后再升级生产任务，并保留依赖锁文件与回滚版本。

风险边界

官方 release 只说明这些修复，不保证团队全部依赖、数据库权限、数据规模或自定义 monkey patch 均兼容。安全加固不能替代输入验证和最小权限；空叠加“不会崩溃”也不等于业务结果正确。

结论

GeoPandas 1.1.4 最适合被当成一个小而明确的维护窗口：写库、抽样、图例、空叠加各跑一条可检查回归。补丁升级完成后保留环境与结果证据，GIS 自动化才能既更新又可追溯。

资料来源