在PHP开发中，处理前端传递或者接口返回的多层嵌套JSON数据是常见需求，很多开发者习惯直接将JSON解码后用foreach遍历，却经常遇到TypeError错误，导致程序无法正常执行。
TypeError产生的常见原因
首先明确，PHP的foreach只能遍历数组或者实现了Traversable接口的对象，如果对非数组、非可遍历对象的数据使用foreach，就会抛出TypeError。在处理多层嵌套JSON时，常见的问题场景有以下几种：
- 调用json_decode时没有设置第二个参数为true，默认返回的是stdClass对象，直接对对象用foreach遍历在PHP8及以上版本会报错
- JSON数据中存在null字段，解码后对应的值为null，用foreach遍历null会触发错误
- 多层嵌套中某一层的字段不是数组类型，比如是字符串或者数字，直接遍历该字段就会出错
- JSON数据格式不合法，解码后返回null，直接遍历null也会报错
解决TypeError的核心步骤
1. 正确解码JSON数据
首先使用json_decode时，第二个参数设置为true，让解码后的数据全部转为关联数组，避免对象类型带来的遍历问题，同时需要校验解码是否成功。
<?php
$jsonStr = '{"user": {"name": "张三", "hobbies": ["篮球", "看书"]}, "status": 1}';
// 第二个参数true，返回数组而非对象
$data = json_decode($jsonStr, true);
// 校验JSON是否解码成功
if (json_last_error() !== JSON_ERROR_NONE) {
echo "JSON格式错误：" . json_last_error_msg();
exit;
}
?>2. 遍历前做类型校验
对每一层需要遍历的数据，先判断是否为数组，再判断数组是否不为空，避免遍历非法类型。可以使用is_array()函数做判断，也可以结合empty()函数处理空值场景。
<?php
// 安全遍历第一层数据
if (is_array($data)) {
foreach ($data as $key => $value) {
echo "键名：$key" . PHP_EOL;
// 遍历第二层嵌套的user字段
if ($key === 'user' && is_array($value)) {
foreach ($value as $userKey => $userVal) {
echo "用户字段：$userKey，值：$userVal" . PHP_EOL;
// 遍历第三层hobbies数组
if ($userKey === 'hobbies' && is_array($userVal)) {
foreach ($userVal as $hobby) {
echo "爱好：$hobby" . PHP_EOL;
}
}
}
}
}
} else {
echo "解码后的数据不是数组，无法遍历";
}
?>3. 封装通用的安全遍历函数
如果项目中经常需要处理多层嵌套的JSON数组遍历，可以封装一个通用的安全遍历函数，避免重复写校验逻辑。
<?php
/**
* 安全遍历数组
* @param mixed $data 待遍历的数据
* @param callable $callback 遍历每个元素时的回调函数
*/
function safeForeach($data, $callback) {
if (!is_array($data)) {
return;
}
foreach ($data as $key => $value) {
$callback($key, $value);
}
}
// 使用封装的函数遍历多层JSON数据
safeForeach($data, function($key, $value) {
echo "外层键：$key" . PHP_EOL;
if ($key === 'user') {
safeForeach($value, function($uKey, $uVal) {
echo "用户层键：$uKey" . PHP_EOL;
if ($uKey === 'hobbies') {
safeForeach($uVal, function($hKey, $hobby) {
echo "爱好：$hobby" . PHP_EOL;
});
}
});
}
});
?>常见错误案例对比
下面通过表格对比错误写法和正确写法的区别，帮助开发者快速避坑：
| 错误写法 | 错误原因 | 正确写法 |
|---|---|---|
json_decode($jsonStr)后直接foreach($data['user'] as ...) | 默认解码返回对象，$data['user']写法错误，且未校验user是否为数组 | json_decode($jsonStr, true)，遍历前用is_array($data['user'])校验 |
| 不校验JSON解码结果直接遍历 | JSON格式错误时解码返回null，遍历null触发TypeError | 先通过json_last_error()判断解码是否成功 |
| 对不确定的字段直接遍历 | 字段可能是字符串、数字等非数组类型，遍历触发错误 | 每次遍历前都用is_array()做类型判断 |
总结
解决PHP多层嵌套JSON数组foreach循环TypeError的核心就是做好数据类型校验，首先正确解码JSON为数组，然后每次遍历前确认待遍历的数据是数组类型，避免对null、对象、标量类型的数据调用foreach。通过封装通用的安全遍历函数，可以简化重复的校验逻辑，提升代码的健壮性和可维护性。