如何递归清理 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": "SGML",           "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 内部增强判断逻辑。

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