展平json_decode返回的多维数组遇数据丢失问题求解决方案

我之前也踩过这个坑！从你的描述和代码片段来看，数据丢失大概率是这几个原因导致的：要么没处理json_decode返回的对象，要么递归逻辑没覆盖所有数据类型，或是键冲突导致值被覆盖。

先排查最容易忽略的点：json_decode的参数 #

默认情况下json_decode($json)返回的是stdClass对象，而不是数组！如果你的代码里没传第二个参数true，那嵌套的对象会被is_array($value)判定为非数组，直接跳过，导致这部分数据丢失。

所以第一步要确保你是这么解码的：

$array = json_decode($your_json_string, true); // 第二个参数true强制返回数组

修正你的展平函数（两种常用实现） #

下面是两种经过验证的展平函数，分别对应不同的需求：

1. 只提取所有值（忽略原键，适合纯嵌套索引数组）

这个版本会把所有嵌套的叶子节点值收集到一个一维数组里，不会丢失任何数据：

function array_flatten($array) {
    // 处理json_decode返回的对象
    if (is_object($array)) {
        $array = (array)$array;
    }
    
    if (!is_array($array)) {
        // 非数组非对象，返回包含当前值的数组（作为递归的终止条件）
        return [$array];
    }
    
    $result = [];
    foreach ($array as $value) {
        // 递归展平每个元素，然后合并到结果数组
        $result = array_merge($result, array_flatten($value));
    }
    return $result;
}

2. 保留原键（避免键冲突，适合关联数组）

如果需要保留原有的键关系，可以给嵌套键加前缀，防止同名键覆盖：

function array_flatten_with_keys($array, $prefix = '') {
    if (is_object($array)) {
        $array = (array)$array;
    }
    
    if (!is_array($array)) {
        return [$prefix => $array];
    }
    
    $result = [];
    foreach ($array as $key => $value) {
        // 构建带前缀的新键，比如`user_contacts_email`
        $new_key = $prefix ? "{$prefix}_{$key}" : $key;
        $result = array_merge($result, array_flatten_with_keys($value, $new_key));
    }
    return $result;
}

为什么你的原代码会丢数据？ #

对照上面的实现，你可以检查自己的代码：

• 没有处理json_decode返回的对象：对象会被is_array($value)跳过，直接丢失
• 递归终止逻辑缺失：当遇到非数组值时，你没有把它加入结果数组，而是直接忽略
• 键冲突未处理：如果直接用$result[$key] = ...，嵌套数组中的同名键会覆盖之前的值

测试示例 #

假设你的JSON数据是：

{
    "user": {
        "name": "Nick",
        "contacts": {"email": "nick@example.com", "phone": ["123", "456"]}
    },
    "posts": [{"title": "First Post"}, {"title": "Second Post"}]
}

用第一个函数展平后会得到：

["Nick", "nick@example.com", "123", "456", "First Post", "Second Post"]

用第二个函数展平后会得到结构清晰的关联数组，所有键值都被保留。

内容的提问来源于stack exchange，提问作者Nick lK