如何递归清理 JSON 中所有值为 null 或空字符串的对象属性

本文介绍使用 javascript 的 `json.stringify` 配合自定义 `replacer` 函数，递归移除 json 中值为 `null` 或空字符串（`''`）的键值对，并深度清理“全空对象”（即所有子属性均被过滤后为空的对象）。

在处理嵌套 JSON 数据时，常需剔除无效字段——如 null、空字符串 ""，甚至进一步删除因此变得“空洞”的对象（例如 { "src": null, "name": null, "alignment": null } 应整体移除）。仅靠简单 replacer 过滤原始值（如 value === null || value === '' ? undefined : value）虽能清除叶子节点，但无法自动删除已变为空的对象，因为 JSON.stringify 默认不会递归塌缩空对象。

✅ 正确方案需两步协同：

1. 第一遍序列化 + replacer：过滤 null 和 ""；
2. 第二遍解析 + 深度清理：用 JSON.parse 配合 reviver，自底向上判断每个对象是否为空（Object.keys(obj).length === 0），若为空则返回 undefined，触发父级删除。

以下是完整、健壮的实现：

function cleanJson(obj) {
  // 第一步：过滤 null 和空字符串
  const cleaned = JSON.parse(
    JSON.stringify(obj, (key, value) => {
      // 排除 null 和空字符串（注意：0、false、[]、{} 等有效值保留）
      if (value === null || value === '') return undefined;
      return value;
    })
  );

  // 第二步：递归移除空对象（包括 {}、{a: {}, b: null} → {b: null} 后 a 被删，最终可能变 {} → 再删）
  function removeEmpty(obj) {
    if (obj === null || typeof obj !== 'object') return obj;

    if (Array.isArray(obj)) {
      return obj.map(removeEmpty).filter(item => item !== undefined);
    }

    const result = {};
    for (const [key, val] of Object.entries(obj)) {
      const cleanedVal = removeEmpty(val);
      if (cleanedVal !== undefined) {
        result[key] = cleanedVal;
      }
    }

    // 若当前对象无任何有效属性，返回 undefined（触发上级删除）
    return Object.keys(result).length === 0 ? undefined : result;
  }

  return removeEmpty(cleaned);
}

// 使用示例
const input = {
  "glossary": {
    "title": "example glossary",
    "GlossDiv": {
      "title": "S",
      "text": null,
      "GlossList": {
        "GlossEntry": {
          "ID": "SGML",
          "SortAs": "SGML",
          "GlossTerm": "Standard Generalized Markup Language",
          "Acronym": "S
GML",
          "Abbrev": "ISO 8879:1986",
          "GlossDef": {
            "para": "A meta-markup language, used to create markup languages such as DocBook.",
            "definition": null
          },
          "GlossSee": "markup",
          "window": {
            "title": "Sample Konfabulator Widget",
            "description": ""
          }
        }
      }
    },
    "image": {
      "src": null,
      "name": null,
      "alignment": null
    },
    "text": {
      "data": "Click Here",
      "size": null,
      "style": "bold",
      "name": "text1",
      "hOffset": "",
      "vOffset": "",
      "alignment": "center",
      "onMouseUp": null
    }
  }
};

console.log(JSON.stringify(cleanJson(input), null, 2));

? 关键注意事项：

• ✅ 该方法保留所有非空原始值：0、false、"0"、" "（带空格）、[]、{}（若未被清空）均不误删；
• ⚠️ replacer 中避免直接 typeof value === 'object' && !value 判断，因 null 是 object 类型，易引发逻辑错误；
• ? 清理是深度优先、自底向上：先清理最深层子对象，再逐层向上判断是否变空；
• ? 如需扩展“空值”定义（如过滤 undefined、空白字符串 /\s+/、空数组 []），可在 removeEmpty 内部增强判断逻辑。

此方案兼顾简洁性与鲁棒性，适用于任意深度嵌套的配置数据清洗场景。