在前后端数据交互过程中，JSON是最常用的数据格式，但实际开发中经常会遇到同一类数据返回格式不统一的情况：部分接口返回单个对象，部分接口返回带索引的数组对象，这会让后续的循环遍历逻辑需要额外增加判断分支，增加代码复杂度。通过标准化JSON数据结构，可以统一两种格式的表现形式，让遍历逻辑更简洁通用。
常见的非标准化JSON结构问题
假设我们有一个用户信息的接口，不同场景下返回的数据结构可能存在差异：
- 单对象场景：接口直接返回单个用户的信息，结构为
{"id":1,"name":"张三"} - 索引对象场景：接口返回多个用户组成的数组，结构为
[{"id":1,"name":"张三"},{"id":2,"name":"李四"}]
如果直接对这两种结构做遍历，就需要先判断数据类型：
// 非标准化的遍历逻辑
const data = 接口返回的数据;
if (Array.isArray(data)) {
data.forEach(item => {
console.log(item.name);
});
} else {
console.log(data.name);
}
当这类接口数量增多时，每个地方都需要写类似的判断逻辑，代码冗余度会明显上升。
标准化JSON数据结构的思路
标准化的核心是将单对象和索引对象统一为数组格式，对于单对象，将其包装为只有一个元素的数组，这样后续遍历逻辑只需要处理数组即可，不需要额外判断。
标准化处理函数实现
我们可以封装一个通用的标准化函数，处理不同类型的输入数据：
/**
* 标准化JSON数据，将单对象或数组统一转为数组格式
* @param {Object|Array} data 原始输入数据
* @returns {Array} 统一后的数组格式数据
*/
function normalizeJsonData(data) {
// 如果数据是null或者undefined，返回空数组
if (data === null || data === undefined) {
return [];
}
// 如果已经是数组，直接返回
if (Array.isArray(data)) {
return data;
}
// 如果是对象，包装为数组
if (typeof data === 'object') {
return [data];
}
// 其他类型返回空数组
return [];
}
标准化后的遍历逻辑
使用标准化函数处理后，遍历逻辑可以统一简化：
// 标准化后的遍历逻辑
const rawData1 = {"id":1,"name":"张三"}; // 单对象
const rawData2 = [{"id":1,"name":"张三"},{"id":2,"name":"李四"}]; // 索引数组
const normalizedData1 = normalizeJsonData(rawData1);
const normalizedData2 = normalizeJsonData(rawData2);
// 统一的遍历逻辑，不需要判断原始类型
normalizedData1.forEach(item => {
console.log(item.name);
});
normalizedData2.forEach(item => {
console.log(item.name);
});
标准化方案的扩展场景
除了基础的单对象和数组转换，还可以根据业务需求扩展标准化逻辑，比如处理嵌套结构的数据：
/**
* 处理嵌套结构的JSON标准化
* @param {Object} data 包含列表字段的原始数据
* @param {String} listKey 列表中存储数据的字段名
* @returns {Array} 标准化后的数组
*/
function normalizeNestedJsonData(data, listKey) {
if (!data || typeof data !== 'object') {
return [];
}
// 提取列表字段的数据
const listData = data[listKey];
return normalizeJsonData(listData);
}
// 示例：原始数据包含data字段存储用户列表
const nestedData = {
code: 200,
data: {"id":1,"name":"张三"}
};
const result = normalizeNestedJsonData(nestedData, 'data');
console.log(result); // 输出 [{id:1,name:"张三"}]
注意事项
- 标准化函数需要根据实际业务的数据类型做调整，比如如果接口可能返回字符串格式的数字，需要额外做类型转换
- 对于空对象或者无效数据，标准化后返回空数组可以避免遍历时出现报错
- 如果原始数据本身需要保留非数组的特殊结构，需要提前和业务方确认标准化规则，避免破坏原有数据逻辑
通过统一JSON数据结构的标准化方案，可以有效减少循环遍历时的类型判断逻辑，让代码更简洁易维护，也能降低因数据结构不统一导致的线上问题概率。
JSON循环遍历数据结构标准化JavaScript修改时间：2026-07-07 05:33:24