PHP json_encode() 默认不过滤 null，需手动清理数据；推荐递归使用 array_filter(ARRAY_FILTER_USE_BOTH) 显式剔除 null 等空值，避免误删 0、false、“0”等有效数据，复杂场景宜用 DTO 或 JsonSerializable 控制序列化。
PHP json_encode() 默认保留 null 值，无法自动过滤
PHP 的 json_encode() 不会主动剔除数组中的 null 值或空字符串、空数组等“空值”，它只做类型映射：PHP null → JSON null。如果你期望输出的 JSON 里完全不出现某个字段（而非设为 null），必须在编码前手动清理数据结构。
常见错误现象：json_encode(['name' => 'Alice', 'age' => null]) 输出 {"name":"Alice","age":null}，但前端可能期望直接省略 age 字段。
- 不能依赖
JSON_FORCE_OBJECT或JSON_UNESCAPED_UNICODE等标志来过滤空值 -
array_filter()默认会移除false、0、""、null，但会重置数字键，导致关联数组变索引数组 —— 这在嵌套结构中极易引发意外 - 若需保留键名，必须显式传入
ARRAY_FILTER_USE_BOTH并自定义回调
用 array_filter() + 自定义回调安全剔除空值
最常用且可控的方式是递归清理数组，对每个值判断是否属于“应剔除的空值”。注意：仅移除 null 是不够的，业务中常还需处理 ''、[]、0（视场景而定）。
function removeEmptyValues($data) {
return array_map(function ($item) {
if (is_array($item)) {
$item = removeEmptyValues($item);
}
return $item;
}, array_filter($data, function ($value, $key) {
// 明确排除 null；如需同时排除空字符串/空数组，可扩展条件
return $value !== null;
}, ARRAY_FILTER_USE_BOTH));
}
使用示例：json_encode(removeEmptyValues(['a' => 'ok', 'b' => null, 'c' => ['x' => null]])) → {"a":"ok","c":{}}。注意：空数组 [] 仍保留，如需进一步清除，需在回调中加 !is_array($value) || !empty($value) 判断。
立即学习“PHP免费学习笔记（深入）”；
注意 0、false、"0" 的语义差异
业务中容易误删有效数据。例如用户年龄为 0、开关状态为 false、订单号为字符串 "0"，它们在松散比较下都等价于空，但语义完全不同。
- 不要无差别用
empty()或!$value做过滤 —— 它会把0、"0"、false全干掉 - 推荐显式枚举需剔除的值：
$value === null || $value === '' || (is_array($value) && empty($value)) - 若字段有明确类型契约（如 API 文档规定某字段只允许 string/number），应在清理前先做类型校验，而非靠过滤兜底
复杂嵌套结构建议用 DTO 类 + 序列化控制
当数据来源多样（数据库、API、表单）、结构深且规则不一时，硬写递归 array_filter 易出错、难维护。更稳健的做法是封装成类，用属性可见性或注解控制序列化行为。
例如用 Laravel 的 toArray() 或 Symfony 的 Serializer 组件，配合 @Groups 或 Ignore 注解跳过特定属性；或手写一个 JsonSerializable 实现：
class User implements JsonSerializable {
public $name;
public $age;
public $avatar;
public function jsonSerialize() {
return array_filter([
'name' => $this->name,
'age' => $this->age !== null ? $this->age : null, // 显式控制
'avatar' => $this->avatar ?: null,
], function ($v) { return $v !== null; });
}
}
这种写法把“哪些字段该出现、何时为空”逻辑收束到类内部，比全局过滤函数更清晰，也更容易单元测试。
真正麻烦的不是怎么删 null，而是搞清哪个 null 是缺省值、哪个是业务上有效的“未设置”、哪个又该转成默认字符串——这些边界往往藏在需求文档角落，而不是代码里。
