为何MapBox判定我生成的GeoJSON无效？请求技术排查

嘿，我帮你梳理几个MapBox加载GeoJSON时容易踩的坑——哪怕你对照基础GeoJSON规范觉得没问题，MapBox的校验逻辑有时候会更严格，这些是高频出错点：

• 检查Feature/FeatureCollection的必填字段完整性
  每个Feature必须同时具备：

  • type: "Feature"（大小写敏感，不能写错）
  • geometry：不能是null，且geometry.type必须是GeoJSON支持的类型（比如"Point"、"LineString"这类，不能拼写错误）
  • properties：哪怕是空对象{}也不能缺失，不能直接省略这个字段
    如果是FeatureCollection结构，必须有type: "FeatureCollection"和features数组（空数组也得保留，不能丢）

• 坐标顺序是不是搞反了！
  这绝对是最常见的错误！GeoJSON要求坐标是**[经度, 纬度]**的顺序，但Foursquare返回的坐标通常是lat（纬度）在前、lng（经度）在后。你得确认转换后的geometry.coordinates是不是把经度放在第一位，比如把Foursquare的location.lng和location.lat按顺序放进数组里，而不是反过来。

• 别多此一举用JSON.stringify！
  MapBox的addSource方法里，data参数接受两种类型：要么是GeoJSON对象，要么是指向GeoJSON文件的URL字符串。如果你已经把Foursquare的数据转成了GeoJSON对象，直接传这个对象就行；要是你先做了JSON.stringify把它转成字符串，MapBox会把它当成URL来解析，自然会报错说无效。比如：

  // ❌ 错误：传了字符串版的GeoJSON
  const geojsonStr = JSON.stringify(geojsonObj);
  this.map.addSource("venues", { type: "geojson", data: geojsonStr });
  
  // ✅ 正确：直接传GeoJSON对象
  this.map.addSource("venues", { type: "geojson", data: geojsonObj });
  

• 检查JSON语法有没有隐藏错误
  转换过程中可能不小心引入了未闭合的括号、特殊字符没转义，或者出现了undefined值（JSON.stringify会把undefined转成null，虽然GeoJSON允许null，但偶尔会触发MapBox的校验异常）。你可以把生成的GeoJSON字符串复制到任意JSON校验工具里检查，看有没有语法问题。

• 属性值类型别踩坑
  虽然MapBox对属性类型的限制不算极端，但如果properties里有不符合JSON规范的值（比如函数、Symbol这类），也会导致解析失败。尽量确保所有属性值都是合法的JSON类型：字符串、数字、布尔、数组、对象或者null。

你可以先从坐标顺序和data参数类型这两个点查起，这俩是绝大多数人遇到这类问题的根源！

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