Python导出GeoDataFrame至BigQuery报BadRequest 400错误解决方案

BigQuery对导入的GEOGRAPHY类型数据严格遵循OGC几何规范：单个Polygon结构中，第一个存储的环必须是最外层的外边界（shell，面积最大、包裹其他所有环），后续环才是嵌套在外边界内部的空洞（hole）。该报错是因为问题行的Polygon环顺序颠倒，把内部空洞放在了第一个环的位置，外边界反而被识别成嵌套在内部的子环，触发校验拦截。

• 全表扫描非法几何，快速定位问题行
  直接用GeoPandas内置的几何合法性校验方法，不需要逐行试错：

  import geopandas as gpd
  # 给所有几何打合法标记
  gdf["valid_flag"] = gdf.geometry.is_valid
  # 筛出所有不合法的行
  error_rows = gdf[~gdf["valid_flag"]]
  print(f"非法几何行索引：{error_rows.index.tolist()}，共{len(error_rows)}条")
  

• 单条校验问题几何
  拿到问题行索引后，单独提取对应几何，打印WKT、计算每个环的面积即可确认环顺序颠倒问题：正常外边界环的面积一定大于所有内部洞的面积，如果第一个环面积远小于后续环，就可以确认是环顺序错误。

方案1：自动修复（优先使用） #

GeoPandas 0.12+版本自带的make_valid()方法可以自动修复绝大多数拓扑错误，包括环顺序颠倒、自相交、重复节点等问题，处理后直接导出即可：

# 替换原几何列为修复后的合法几何
gdf["geometry"] = gdf.geometry.make_valid()
# 二次校验确认无剩余错误
if not gdf.geometry.is_valid.all():
    raise ValueError("仍存在无法自动修复的非法几何，请手动核查")

方案2：手动修复（适配自动修复失效的特殊场景） #

如果自动修复没有解决环顺序问题，可以写逻辑手动重排多边形环顺序：按环围成的面积降序排列，面积最大的环作为外边界放在第一个位置，剩余环作为内部空洞：

from shapely.geometry import Polygon, MultiPolygon

def reorder_polygon_rings(geom):
    # 点、线等非多边形几何直接返回
    if geom.geom_type not in ["Polygon", "MultiPolygon"]:
        return geom
    
    # 处理单个多边形
    if geom.geom_type == "Polygon":
        all_rings = list(geom.interiors) + [geom.exterior]
        # 按环面积降序排序，第一个就是外边界
        all_rings_sorted = sorted(all_rings, key=lambda r: Polygon(r).area, reverse=True)
        shell = all_rings_sorted[0]
        holes = all_rings_sorted[1:]
        return Polygon(shell, holes)
    
    # 处理多多边形，逐个修正子多边形
    fixed_sub_polys = []
    for sub_poly in geom.geoms:
        all_rings = list(sub_poly.interiors) + [sub_poly.exterior]
        all_rings_sorted = sorted(all_rings, key=lambda r: Polygon(r).area, reverse=True)
        shell = all_rings_sorted[0]
        holes = all_rings_sorted[1:]
        fixed_sub_polys.append(Polygon(shell, holes))
    return MultiPolygon(fixed_sub_polys)

# 应用修复逻辑
gdf["geometry"] = gdf.geometry.apply(reorder_polygon_rings)

修复注意事项：修复完成后建议抽样对比修复前后的几何面积、边界范围，确认没有出现几何变形、范围偏移的问题，再执行导出到BigQuery的操作。

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