PHP去除数组空值转JSON的关键是明确定义“空”：仅剔除null、纯空白字符串和空数组，保留0、false、“0”等合法值，否则JSON API易返回错误数据。
PHP 去除数组空值后转 JSON，关键不在“转”，而在“怎么定义空”——empty() 会误删 0、"0"、false，JSON API 接口常因此返回错误数据。
为什么 array_filter() 默认行为不适合 JSON API
直接用 array_filter($arr) 会过滤掉所有被 empty() 判定为假的值，包括：0、0.0、"0"、false、null、""。但 JSON API 场景中，"0" 和 0 往往是合法业务值（如商品库存为 0、开关状态为 0）。
- 接口返回
{"status":0,"msg":"success"}，若用默认array_filter，"status":0会被删掉 -
["id"=>1,"price"=>0,"desc"=>""]中，"price"消失，"desc"也消失，但语义不同：价格可为 0，描述为空才应剔除 - PHP 8.0+ 的
array_filter($arr, fn($v) => $v !== null && $v !== '')仍漏掉空白字符串变体（如" \t\n"）
推荐做法：显式声明“哪些算空”，用 array_walk_recursive() 或递归函数清理
JSON API 多为嵌套结构（如 data.attributes），需深层遍历；且“空”的定义应统一为：null、纯空白字符串（trim($v) === ''）、空数组（is_array($v) && count($v) === 0），而保留 0、false、"0"。
function removeEmptyValues($arr) {
return array_map(function ($v) {
if (is_array($v)) {
$v = removeEmptyValues($v);
return empty($v) && !array_keys($v) ? null : $v;
}
return ($v === null || (is_string($v) && trim($v) === '')) ? null : $v;
}, $arr);
}
// 使用后需再过滤掉 null 值（仅顶层）
$result = array_filter(removeEmptyValues($input), function($v) { return $v !== null; });
- 不依赖
empty()，避免误伤数字和布尔值 - 对字符串强制
trim()，兼容全角空格、换行等 - 空数组判为
null，但若需保留空数组（如"tags":[]是合法字段），则去掉empty($v) && !array_keys($v)这段逻辑 - 注意：该函数不处理对象，若输入含
stdClass，需先(array)$obj转换或改用json_encode(..., JSON_FORCE_OBJECT)统一路径
输出前必须检查 json_last_error()
即使数组清理干净，仍可能因 UTF-8 编码问题、循环引用（虽少见）、或超大嵌套深度导致 json_encode() 返回 false，而 JSON API 规范要求明确错误响应。
立即学习“PHP免费学习笔记（深入）”；
- 永远不要写
echo json_encode($data);就完事 - 必须加判断：
if (($json = json_encode($data)) === false) { http_response_code(500); echo json_encode(['error' => 'JSON encode failed: '.json_last_error_msg()]); exit; } - 开发期可加
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES避免中文被编码、URL 被转义，但生产环境注意 CDN 或代理是否兼容 - 若数组含资源（如
mysqli_result）、闭包、不可序列化对象，json_encode直接静默失败，需提前unset()或转换
真正麻烦的不是“怎么删空值”，而是团队对“空”的定义是否一致——前端传 {"name":""} 算清空还是忽略？数据库字段允许 NULL 还是默认 ''？这些边界一旦没对齐，清理逻辑再严谨，API 依然会出错。
