JSON解析失败必抛SyntaxError,须用try...catch捕获并仅处理该错误类型,返回默认值或上抛;预检字符串类型和空值可优化性能,但不可替代parse执行验证。

JavaScript 中解析 JSON 失败时会抛出 SyntaxError,必须用 try...catch 捕获,否则程序中断。关键不是“避免报错”,而是“安全地处理不可控输入”。
用 try...catch 包裹 JSON.parse()
这是最直接、最可靠的方式。任何非法 JSON 字符串(如末尾多逗号、单引号、undefined、空字符串、纯数字等)都会触发异常。
- 把
JSON.parse()放在try块中 - 在
catch中判断错误类型,只处理SyntaxError(避免吞掉其他意外错误) - 返回默认值、空对象或记录日志,根据业务决定
function safeParse(jsonStr) {
try {
return JSON.parse(jsonStr);
} catch (err) {
if (err instanceof SyntaxError) {
console.warn('JSON 解析失败:', err.message, '输入:', jsonStr);
return null; // 或 {}、[] 等兜底值
}
throw err; // 其他错误不捕获,继续上抛
}
}
提前校验字符串有效性(可选增强)
仅靠 try...catch 已足够,但若想减少异常开销(高频解析场景),可加轻量预检:
- 检查是否为字符串类型且非空
- 用正则粗略排除明显非法开头(如
/^\s*[\{\[].*[\}\]]\s*$/s),但注意:正则不能替代JSON.parse,只是快速过滤 - 真正安全的判断仍依赖
JSON.parse执行结果
JSON.parse(JSON.stringify(...)) 回绕验证——这解决不了原始字符串问题,还可能引入新错误。
常见导致解析失败的输入及应对
后端返回、localStorage 读取、用户输入等都可能含脏数据:
立即学习“Java免费学习笔记(深入)”;
-
undefined / null / number / boolean:不是字符串,直接传给
JSON.parse会报错 → 先typeof === 'string'判断 -
单引号包裹:JSON 标准要求双引号 → 不要手动替换引号(易出错),应让上游修复,或用库如
json5(非标准但宽容) - 尾部逗号、注释、undefined 字面量:都不是合法 JSON → 必须由数据提供方修正,前端不做“智能修复”
-
编码问题(如 UTF-8 BOM):字符串开头含
\uFEFF会导致解析失败 → 可先.trimStart()或正则清理
封装成可复用的工具函数
项目中建议统一处理,避免重复写 try...catch:
- 支持传入默认值(类似
JSON.parse(str) ?? {},但更健壮) - 可选开启调试日志
- 兼容旧环境时注意
instanceof SyntaxError在某些 IE 版本下可能不准,可用err.name === 'SyntaxError'替代
const parseJSON = (str, defaultValue = null) => {
if (typeof str !== 'string' || !str.trim()) return defaultValue;
try {
return JSON.parse(str);
} catch (e) {
return defaultValue;
}
};


















