本文介绍如何在从数据库循环构建多维关联数组时，精准剔除未初始化或为空的子数组（如缺失的 `id_tipo_profissional_2`），避免生成含空键（如 `""`）和 `null` 值的无效结构，确保 json 输出干净、语义正确。
在 PHP 中处理数据库查询结果并组织为嵌套结构时，一个常见痛点是：当某类数据（如 id_tipo_profissional == '2'）在当前结果集中完全不存在时，相关变量（如 $id_tipo_profissional_2、$profissionais_2）未被赋值或为 null，但后续仍被强行写入最终数组——导致出现 "": { ... } 这样的非法空键及 null 字段，破坏数据一致性与前端解析逻辑。
根本原因在于原代码中使用了 静态数组构造 + array_filter() 的方式：
$resultado = array_filter([
"tipo" => [
$id_tipo_profissional_1 => [ /* ... */ ],
$id_tipo_profissional_2 => [ /* ... */ ], // 若 $id_tipo_profissional_2 为 null，键变为 ""
]
]);⚠️ 注意：array_filter() 默认仅过滤值为 falsy 的元素（如 null, false, 0, "", []），但它不会删除键名本身为 null 或空字符串的数组项；更关键的是，PHP 在用 null 作为数组键时会自动转换为 ""（空字符串），从而产生 "": {...} 条目——而这恰恰是 array_filter() 无法识别并清除的。
✅ 正确解法是：按需构建（Build Conditionally），即只在变量有效（非空、已定义、非 null）时才将其加入目标结构。这比事后过滤更高效、更可靠。
立即学习“PHP免费学习笔记（深入）”；
以下是重构后的推荐写法：
// 初始化主容器
$resultado = ['tipo' => []];
// 仅当类型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 ?? []
];
}
// 安全返回 JSON（自动处理 null/empty）
return json_encode($resultado, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);? 关键改进点说明：
- 使用 isset() + 显式非空判断，避免未定义变量触发 Notice；
- 对 $profissionais_X 使用 ?? [] 提供默认空数组，防止 null 进入 profissionais 字段；
- 直接构建 $resultado['tipo']，跳过冗余中间数组和无效 array_filter() 调用；
- 添加 JSON_UNESCAPED_UNICODE 确保中文不被编码为 \uXXXX，提升可读性。
? 扩展建议：若未来类型数量增加（如支持 3、4、5…），可进一步抽象为配置驱动模式：
$types = [
'1' => ['var_id' => 'id_tipo_profissional_1', 'var_name' => 'tipo_profissional_1', 'var_data' => 'profissionais_1'],
'2' => ['var_id' => 'id_tipo_profissional_2', 'var_name' => 'tipo_profissional_2', 'var_data' => 'profissionais_2'],
];
foreach ($types as $key => $config) {
if (isset(${$config['var_id']}) && ${$config['var_id']} === $key) {
$resultado['tipo'][$key] = [
'id_tipo_profissional' => ${$config['var_id']},
'nome_tipo_profissional' => ${$config['var_name']},
'profissionais' => ${$config['var_data']} ?? []
];
}
}总结：动态构建优于静态填充后过滤。始终优先检查变量是否已定义且有效，再决定是否纳入结构——这是保障 API 数据质量、提升系统健壮性的核心实践。
