JSON.parse() 报错主因是输入非合法字符串,需先校验类型并捕获异常;深层嵌套用可选链与空值合并;特殊类型需 replacer/reviver 处理;大文件应移至 Web Worker 解析。

JSON.parse() 会直接报错?先确认输入是不是合法字符串
很多问题其实卡在第一步:JSON.parse() 只接受严格格式的字符串,不是对象、不是 undefined、不能有多余逗号或单引号。常见错误包括:
-
后端返回的是已解析过的对象(比如 Axios 默认已解析),再调一次
JSON.parse()就会报Unexpected token o in JSON at position 1 - 接口返回了 HTML 错误页(比如 500 页面),内容是
...,根本不是 JSON - 字符串里有未转义的换行、制表符或 Unicode 控制字符(如
\u2028)
安全做法是先做类型和格式校验:
function safeParse(jsonStr) {
if (typeof jsonStr !== 'string') return null;
try {
return JSON.parse(jsonStr);
} catch (e) {
console.warn('JSON parse failed:', e.message, 'input:', jsonStr.slice(0, 100));
return null;
}
}
嵌套对象/数组太多层?用递归遍历比硬写 data.a.b.c.d.e 更可靠
面对类似 {user: {profile: {settings: {theme: 'dark'}}}} 这种结构,直接链式访问容易因某层为 null 或 undefined 报错。别靠层层 if 判断,用可选链(?.)+ 空值合并(??)更简洁:
const theme = data?.user?.profile?.settings?.theme ?? 'light';
如果要遍历整个结构(比如提取所有 ID 字段),递归函数比手动展开更可控:
立即学习“Java免费学习笔记(深入)”;
function findAllIds(obj, ids = []) {
if (Array.isArray(obj)) {
obj.forEach(item => findAllIds(item, ids));
} else if (obj && typeof obj === 'object') {
if ('id' in obj) ids.push(obj.id);
Object.values(obj).forEach(val => findAllIds(val, ids));
}
return ids;
}
遇到日期字符串、BigInt、RegExp 怎么办?JSON 本身不支持它们
JSON.stringify() 会静默丢弃 undefined、函数、Symbol;遇到 Date 只保留 ISO 字符串,BigInt 直接抛错:TypeError: Do not know how to serialize a BigInt。
解决方案分两层:
- 序列化时:用
replacer函数预处理 - 解析后:用
reviver函数还原特殊类型
例如把字符串按约定前缀转回 Date:
const revived = JSON.parse(jsonStr, (key, value) => {
if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value)) {
return new Date(value);
}
return value;
});
注意:reviver 对每个键值对都调用,性能敏感场景需加判断条件,避免无谓检查。
大 JSON 文件卡死页面?别在主线程里 parse
解析几 MB 的 JSON 会阻塞渲染,用户操作无响应。浏览器没提供原生流式 JSON 解析,但可用 Web Worker 搬离主线程:
// worker.js
self.onmessage = function(e) {
try {
const result = JSON.parse(e.data);
self.postMessage({ success: true, data: result });
} catch (err) {
self.postMessage({ success: false, error: err.message });
}
};
主线程中:
const worker = new Worker('worker.js');
worker.postMessage(largeJsonString);
worker.onmessage = ({ data }) => {
if (data.success) useParsedData(data.data);
};
更重的场景(如 GB 级日志)得用流式解析库(如 stream-json),但那已超出原生 JSON 能力范围——这时候该考虑换数据协议了。
真正麻烦的不是语法解析,而是你拿到的数据根本没文档、字段含义模糊、同一字段有时是字符串有时是对象。这种时候,JSON.parse 成功只是第一步,后续校验和类型断言反而更花时间。











