Folium无法显示边界与数据的技术问题求助

问题核心原因 #

1. 大文件解析与渲染限制：130MB的GeoJSON属于大体积地理数据，用Python原生json模块解析后直接传入Folium，会导致前端浏览器无法高效处理这么大的原始JSON对象，大概率出现隐性渲染失败（无报错但不显示）。而GeoPandas依赖GEOS等底层优化库，会自动对地理数据做内存优化、格式标准化，传递给Folium时的数据格式更适配前端渲染。
2. GeoJSON格式细节兼容问题：ONS发布的GeoJSON可能存在一些非标准格式细节（比如嵌套属性、无效几何对象、坐标系隐性问题），Folium原生GeoJson类对这类不规范格式容错性较低；GeoPandas会自动修复格式问题、标准化几何对象，消除这类兼容障碍。
3. Choropleth参数匹配错误：若用json模块加载数据时，key_on参数的字段路径设置错误（比如ONS GeoJSON的ID字段实际是feature.properties.LAD21CD而非你预设的ID），会导致Choropleth无法关联CSV数据，同时GeoJSON边界渲染也可能受影响。GeoPandas在合并数据后传入时，字段匹配逻辑更顺畅，避免了这类路径错误。

具体解决方向 #

• 沿用GeoPandas工作流（最便捷）
  既然GeoPandas能正常渲染，直接基于这个流程优化即可，示例代码：

  import geopandas as gpd
  import pandas as pd
  import folium
  
  # 加载地理数据和统计数据
  gdf = gpd.read_file('ons_geojson.geojson')
  pop_df = pd.read_csv('population.csv')
  
  # 关联地理与统计数据
  merged_data = gdf.merge(pop_df, left_on='LAD21CD', right_on='match_id')
  
  # 生成地图
  m = folium.Map(location=[54.0, -2.0], zoom_start=6)
  folium.Choropleth(
      geo_data=merged_data,
      data=merged_data,
      columns=['LAD21CD', 'population'],
      key_on='feature.properties.LAD21CD',
      fill_color='YlOrRd',
      legend_name='Local Authority Population'
  ).add_to(m)
  
  m.save('uk_pop_map.html')
  

• 优化原始GeoJSON文件
  用GeoPandas读取原始文件后，导出简化/标准化的GeoJSON，再用json模块加载：

  import geopandas as gpd
  
  gdf = gpd.read_file('ons_geojson.geojson')
  # 简化几何图形（保留90%细节，大幅缩小文件）
  gdf['geometry'] = gdf['geometry'].simplify(tolerance=0.01)
  gdf.to_file('simplified_ons.geojson', driver='GeoJSON')
  

  之后用json模块加载这个简化后的文件，再传入Folium测试。

• 验证Choropleth参数正确性
  打印json加载后的GeoJSON结构，确认ID字段的实际路径：

  import json
  
  with open('ons_geojson.geojson') as f:
      gb_json = json.load(f)
  # 查看第一个要素的属性字段
  print(gb_json['features'][0]['properties'])
  

  根据输出结果修正Choropleth的key_on参数，确保和GeoJSON中的字段路径完全匹配。

• 前端调试定位问题
  将Folium生成的HTML文件在浏览器中打开，按F12打开开发者工具，查看Console面板的报错信息——如果是内存溢出、GeoJSON解析错误，会直接显示具体问题，针对性调整。

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