向Google Maps API添加GeoJson报错：Uncaught not a Feature or FeatureCollection

这种情况我之前帮朋友排查过好几次，核心问题出在AJAX获取数据的解析逻辑或者PHP输出的响应格式上——毕竟直接粘贴能正常运行，说明你的GeoJSON本身是没问题的，问题出在从PHP到前端的传输环节。下面是最常见的几个原因和对应的解决办法：

1. AJAX返回的是字符串，而非JavaScript对象 #

map.data.addGeoJson() 要求传入的是JavaScript对象，但通过AJAX请求默认拿到的是原始JSON字符串（除非你主动指定解析规则）。直接粘贴GeoJSON内容时，浏览器会自动把它识别为JS对象字面量，自然能正常运行；但AJAX拿到的字符串如果不转换，就会触发报错。

解决办法：

• 要么在AJAX请求里指定dataType: 'json'，让jQuery自动帮你把响应解析成对象：

$.ajax({
  url: '你的PHP文件路径.php',
  dataType: 'json',
  success: function(geoJsonData) {
    map.data.addGeoJson(geoJsonData);
  },
  error: function(xhr, status, err) {
    console.log('解析失败:', err);
  }
});

• 要么手动用JSON.parse()转换字符串：

$.get('你的PHP文件路径.php', function(response) {
  try {
    var geoJsonObj = JSON.parse(response);
    map.data.addGeoJson(geoJsonObj);
  } catch(e) {
    console.log('JSON解析错误:', e);
  }
});

2. PHP没有设置正确的响应头 #

GIS软件对响应头的要求比较宽松，但前端AJAX请求很依赖Content-Type来判断如何解析数据。如果你的PHP文件默认返回text/html类型，jQuery不会自动把响应当作JSON处理。

解决办法：在PHP代码最开头添加响应头设置（一定要在输出任何内容之前，包括空格、换行）：

<?php
header('Content-Type: application/json; charset=utf-8');
// 后面是你的PostGIS查询、GeoJSON生成代码
?>

3. PHP输出的GeoJSON带有隐形字符 #

如果你的PHP文件保存为UTF-8带BOM格式，输出的GeoJSON开头会多出三个隐形字符\ufeff，GIS软件能忽略，但JSON解析器会直接报错。另外，如果PHP代码里有调试用的echo、print_r，或者输出了错误提示，也会破坏GeoJSON的完整性。

解决办法：

• 把PHP文件保存为UTF-8无BOM格式（大多数编辑器都有这个选项，比如VS Code、Notepad++）；
• 在输出GeoJSON前清空缓冲区，避免多余内容：

<?php
ob_clean();
header('Content-Type: application/json; charset=utf-8');
// 后续生成并输出GeoJSON的代码
?>

• 检查PHP错误日志，关闭不必要的错误输出（生产环境可以设置error_reporting(0);）。

快速测试技巧 #

直接在浏览器地址栏打开你的PHP文件，查看页面源代码，复制全部内容后用JSON.parse()在浏览器控制台测试，如果报错，说明PHP输出的JSON本身有问题；如果能正常解析，那就是前端AJAX的解析逻辑需要调整。

内容的提问来源于stack exchange，提问作者Geo-x