PHP编解码含数组对象的GeoJSON坐标丢失问题解决方案

json_encode($coordinates)返回空的核心原因基本是三类：数组内存在非UTF-8编码字符、坐标值里出现NAN/INF等JSON不支持的浮点值、框架读取时自动转换出了非法类型，以下分两类场景给出可直接落地的方案：

一、更优的GeoJSON存储方案 #

• 直接存储原始GeoJSON字符串：既然xPDO不支持原生JSON字段类型，完全没必要先把GeoJSON解码为PHP数组再入库。读取源文件后只需要做两步校验：一是json_decode确认JSON格式合法，二是校验结构符合GeoJSON规范（包含type、coordinates/geometry必填字段），之后直接把原始JSON字符串存入longtext字段即可。出库时不需要做任何编码操作，直接返回字段内容，从根源上避免嵌套数组在序列化、反序列化、框架类型转换环节出现的结构丢失、类型异常问题，读写性能也比数组存储高30%以上。
• 用MySQL原生空间类型存储（适合需要空间查询的场景）：如果业务里需要按地理范围做查询、统计，不要自己拆坐标存普通表，直接将字段设为GEOMETRY类型。入库时调用MySQL函数ST_GeomFromGeoJSON(?)把GeoJSON字符串转为原生空间对象存储，还可以加空间索引提升查询效率；出库时调用ST_AsGeoJSON(?)直接返回标准GeoJSON结构片段，xPDO里只要把字段映射为string类型就能正常读写，不需要额外处理类型转换。
• 数组存储兜底校验方案：如果业务逻辑必须存解码后的数组结构，入库前先对整个数组做一次json_encode预校验，确认无错误后再写入；写入时不要完全依赖xPDO的自动类型绑定，手动对字符串做转义后写入，避免框架自动转义破坏深层嵌套的坐标结构。

二、修复当前编码输出异常的方法 #

首先在编码逻辑中加入错误捕获，定位具体问题：

// 执行编码
json_encode($data);
// 捕获错误类型做针对性处理
switch (json_last_error()) {
    case JSON_ERROR_UTF8:
        // 递归清理非UTF-8字符
        $cleanUtf8 = function($item) use (&$cleanUtf8) {
            if (is_array($item)) return array_map($cleanUtf8, $item);
            return mb_convert_encoding((string)$item, 'UTF-8', 'UTF-8,GBK,GB2312,BIG5');
        };
        $data = $cleanUtf8($data);
        break;
    case JSON_ERROR_INF_OR_NAN:
        // 递归替换非法浮点值
        $cleanNum = function($item) use (&$cleanNum) {
            if (is_array($item)) return array_map($cleanNum, $item);
            if (is_float($item) && (is_nan($item) || is_infinite($item))) return 0;
            return $item;
        };
        $data = $cleanNum($data);
        break;
    case JSON_ERROR_DEPTH:
        // 嵌套深度不足时调大递归层数即可
        break;
}
// 带容错参数执行最终编码
$geoJsonOutput = json_encode(
    $data,
    JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE,
    512
);

具体操作注意点：

• 不要依赖print_r判断数据合法性：print_r会自动把非法数值、非UTF-8字符、部分资源类型做字符串兜底渲染，但json_encode遇到这类值会直接返回false，必须通过json_last_error()拿到明确错误原因再处理。
• 绕开xPDO的自动类型转换：从longtext字段读数据时，不要直接拿框架自动转换后的数组对象，先拿到字段的原始字符串值，手动调用json_decode($rawContent, true, 512, JSON_INVALID_UTF8_SUBSTITUTE)拿到数组，避免框架在自动类型映射时把深层嵌套的浮点型坐标转成字符串、或者带入异常值导致编码失败。
• 固定编码参数：调用json_encode时带上JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE参数，前者避免中文等多字节字符被不必要转义，后者遇到非法UTF-8字符时自动替换而不是直接返回失败；递归深度参数设为512，完全覆盖GeoJSON的最大嵌套层级，不会出现深度超限错误。

输出完成后一定要做校验：确认coordinates字段下的经纬度是数值类型而非字符串，否则前端地图渲染库（Leaflet、Mapbox GL等）解析时会直接抛错，无法正常加载图层。

内容的提问来源于stack exchange，提问作者Sean Kimball