JSON.parse() 解析失败必定抛出 SyntaxError 异常而非返回 null；空字符串、null、undefined 均报错；不支持尾随逗号、注释、undefined、NaN、函数；需用 try...catch 包裹并校验输入类型与 content-type。
JSON.parse() 会直接抛出语法错误，不返回 null
很多人误以为 JSON.parse() 解析失败会返回 null 或 undefined，实际它**一定会抛出 SyntaxError 异常**——哪怕只是多了一个逗号、少了一个引号，或用了单引号。没加 try...catch 就调用，代码立刻中断。
正确做法是始终包裹异常处理：
function safeParse(jsonStr) {
try {
return JSON.parse(jsonStr);
} catch (err) {
if (err instanceof SyntaxError) {
console.error('JSON 格式错误:', err.message);
return null;
}
throw err; // 其他错误（如内存溢出）不吞掉
}
}空字符串、null、undefined 传给 JSON.parse() 都会报错
JSON.parse('')、JSON.parse(null)、JSON.parse(undefined) 全部触发 SyntaxError。常见于后端返回空响应体、fetch 未检查 response.ok 就直接解析。
- 前端取值前先做类型和非空判断：
if (typeof jsonStr === 'string' && jsonStr.trim()) - fetch 场景中，务必检查
response.status和response.headers.get('content-type')是否含application/json - 不要依赖「后端一定返回 JSON」——网络抖动、网关拦截、mock 数据缺失都可能导致空响应
JSON.parse() 不支持尾随逗号、注释、undefined、NaN、函数
这些写法在 JS 对象字面量中合法，但**不是标准 JSON**，JSON.parse() 一律拒绝：
立即学习“Java免费学习笔记（深入）”；
// ❌ 全部报错
JSON.parse('{ "a": 1, }');
JSON.parse('{ /* comment */ "a": 1 }');
JSON.parse('{ "a": undefined }');
JSON.parse('{ "a": NaN }');
JSON.parse('{ "fn": function(){} }');如果需要解析带注释或扩展语法的配置，得换工具（如 json5 库），但要注意：这不是浏览器原生能力，需额外打包引入。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
另外，JSON.parse() 对超大字符串（比如 >100MB）可能触发内存限制或卡死主线程，服务端返回前应做 size 检查，前端可加 AbortController 超时控制。
reviver 参数能过滤/转换字段，但别在里头改结构
JSON.parse(jsonStr, reviver) 的 reviver 是个回调函数，接收 (key, value)，可用于脱敏、类型修正（如把字符串日期转 Date）或剔除敏感字段。
但要注意：
-
reviver中修改value后返回新值，才会被采用；返回undefined会删掉该 key - 不要在
reviver中对嵌套对象做深克隆或复杂计算——它按深度优先遍历每个键值对，性能敏感 - 不能靠它修复语法错误，也不能改变顶层结构（比如把对象转成数组）
典型安全用法：
const data = JSON.parse(jsonStr, (key, value) => {
if (key === 'token' || key === 'password') return undefined; // 过滤敏感字段
if (key === 'createdAt' && typeof value === 'string') return new Date(value); // 转日期
return value;
});实际项目中最容易漏的是空响应和 content-type 误判——这两个点比语法细节更容易导致线上白屏。
