如何将数据库查询返回的 stdClass 对象数组正确转换为关联数组以去重

2026-01-16 00:00:00 作者：聖光之護

本文详解如何将 php 中由 sql 查询返回的 stdclass 对象数组（如 pdo 或 mysqli 查询结果）安全、准确地转换为纯 php 关联数组，避免“cannot use object of type stdclass as array”错误，并支持后续的去重、过滤等数组操作。

你遇到的错误 Cannot use object of type stdClass as array 并非因为类型转换失败，而是因为 (array)$object_name 的强制转换行为与预期不符——它并未递归转换嵌套对象，而只是将最外层容器转为数组。从你的输出可见：$object_name 本身就是一个 包含多个 stdClass 对象的数组（即 array），而非单个对象。因此，(array)$object_name 实际上是冗余操作，原数组结构未变；当你随后尝试用 $arr[0]['name_of_body_part'] 这样的语法访问时，PHP 会试图把 stdClass 当作数组下标访问，从而抛出致命错误。

✅ 正确做法是：确保每个 stdClass 对象都被递归转换为关联数组。推荐使用以下两种经过验证的方法：

✅ 方法一：json_encode() + json_decode()（推荐，简洁通用）

// 假设 $object_name 是从数据库获取的对象数组（例如 PDO::FETCH_OBJ 结果）
$arr = json_decode(json_encode($object_name), true);

该方案先将整个对象数组序列化为 JSON 字符串，再以 true 参数解析为纯关联数组（而非 stdClass 对象）。它能深度处理任意嵌套结构，兼容性好，且代码简洁。

⚠️ 注意：此方法要求对象属性值可被 JSON 序列化（不支持资源、闭包、DateTime 等）。对于标准数据库字段（字符串、数字、null），完全安全。

✅ 方法二：手动遍历 + get_object_vars()（更可控，无 JSON 依赖）

$arr = [];
foreach ($object_name as $obj) {
    $arr[] = get_object_vars($obj); // 将每个 stdClass 转为关联数组
}

get_object_vars() 仅提取对象的公共属性并返回关联数组，轻量、高效、无序列化开销，适合对性能敏感或含不可序列化数据的场景。

✅ 后续去重示例（基于 name_of_condition 字段）

转换完成后，即可安全使用数组函数去重：

// 按 condition 名称去重，保留首次出现项
$unique = [];
$seen = [];
foreach ($arr as $item) {
    $key = $item['name_of_condition'] ?? '';
    if (!in_array($key, $seen)) {
        $seen[] = $key;
        $unique[] = $item;
    }
}
// $unique 现在是去重后的关联数组

❌ 为什么 (array)$object_name 不行？

(array) 强制转换仅作用于最外层变量，对内部元素无影响；
它无法将 stdClass 实例转为数组，仅改变
容器类型（若原为对象则转为属性数组，但此处原已是数组）；
因此 $arr[0] 仍是 stdClass，$arr[0]['id'] 会报错。

总结

方案	适用场景	优点	注意事项
json_decode(json_encode($obj), true)	大多数场景，结构简单	一行解决，自动深层转换	避免含资源/资源句柄
array_map('get_object_vars', $obj)	高性能要求或含复杂对象	零序列化开销，语义清晰	仅支持 public 属性