本文介绍如何在 php 中安全地构建包含多个子数组的嵌套结构，并通过条件判断精准剔除未初始化或为空的子数组项，避免生成无效键（如空字符串键 `""`）和 `null` 值，确保最终 json 输出结构干净、符合预期。
在处理数据库查询结果并按类型分组构建多维数组时，一个常见问题是：当某类数据（如 id_tipo_profissional == 2）在当前查询结果中完全不存在时，其对应变量（如 $id_tipo_profissional_2、$profissionais_2）未被赋值或为 null，但后续仍被强行写入最终数组——导致出现 "": { ... } 这样的非法空键及 null 字段，破坏 JSON 结构的语义完整性与前端解析稳定性。
根本原因在于原代码使用了无条件构造 + array_filter() 后置过滤的方式：
$resultado = array_filter([
"tipo" => [
$id_tipo_profissional_1 => [ /* ... */ ],
$id_tipo_profissional_2 => [ /* ... */ ],
],
]);⚠️ 注意：array_filter() 默认仅过滤值为 falsy 的元素（如 null, false, 0, "", []），但此处的问题是键名本身为 ""（空字符串），而该键对应的值（如 ['id_tipo_profissional' => null, ...]）可能因 PHP 类型转换未被彻底判定为 falsy（尤其当数组含 null 但非空时），导致空键残留。
✅ 正确解法是：前置条件校验 + 动态构建，即只在数据真正有效时才向目标数组添加对应条目。
立即学习“PHP免费学习笔记（深入）”；
以下是优化后的完整逻辑（兼容 PHP 7.4+，兼顾可读性与健壮性）：
// 初始化主容器
$resultado = ['tipo' => []];
// 处理类型 1（需确保 $profissionais_1 已声明且非空，或至少 $id_tipo_profissional_1 有效）
if (isset($id_tipo_profissional_1) && $id_tipo_profissional_1 !== '') {
$resultado['tipo'][$id_tipo_profissional_1] = [
'id_tipo_profissional' => $id_tipo_profissional_1,
'nome_tipo_profissional' => $tipo_profissional_1,
'profissionais' => $profissionais_1 ?? []
];
}
// 处理类型 2（同理）
if (isset($id_tipo_profissional_2) && $id_tipo_profissional_2 !== '') {
$resultado['tipo'][$id_tipo_profissional_2] = [
'id_tipo_profissional' => $id_tipo_profissional_2,
'nome_tipo_profissional' => $tipo_profissional_2,
'profissionais' => $profissionais_2 ?? []
];
}
// 可选：进一步清理空 profissionais 数组（若业务要求“无人员则不保留该类型”）
foreach ($resultado['tipo'] as $key => &$item) {
if (empty($item['profissionais'])) {
unset($resultado['tipo'][$key]);
}
}
unset($item); // 解除引用
return json_encode($resultado, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);? 关键改进点说明：
- ✅ 使用 isset() + 显式非空判断，避免未定义变量触发 Notice；
- ✅ ?? [] 提供安全默认值，防止 profissionais_* 未定义导致 null；
- ✅ empty($item['profissionais']) 可选二次过滤：若某类型下无任何专业人员，则彻底移除该类型节点（更贴近真实业务场景）；
- ✅ JSON_UNESCAPED_UNICODE 确保中文不被转义，JSON_PRETTY_PRINT 便于调试（上线前可移除）。
? 进阶建议：
对于更多类型（如 3, 4…），推荐将逻辑抽象为循环或映射配置，避免重复 if 块。例如：
$types = [
'1' => [&$id_tipo_profissional_1, &$tipo_profissional_1, &$profissionais_1],
'2' => [&$id_tipo_profissional_2, &$tipo_profissional_2, &$profissionais_2],
];
foreach ($types as $id => [$idRef, $nameRef, $profsRef]) {
if (isset($idRef) && $idRef == $id) {
$resultado['tipo'][$id] = [
'id_tipo_profissional' => $idRef,
'nome_tipo_profissional' => $nameRef,
'profissionais' => $profsRef ?? []
];
}
}这样既保持扩展性，又消除冗余代码。最终输出将严格匹配期望结构——无空键、无 null 字段、语义清晰，为前后端协作奠定坚实基础。
