JSON常见踩坑问题与实战避坑案例代码
JSON这个东西，看起来简单，用起来却暗藏不少陷阱。前后端交互、配置文件、数据存储，几乎每个项目都离不开它。轻量、易解析是它的优势，但在日常开发中，语法书写、数据类型、转义字符、解析规则这些细节，稍不留神就会引发报错、数据紊乱，甚至程序直接崩溃。今天我们就结合真实开发场景，把那些高频踩坑点一一梳理出来，配上可直接运行的代码，看看问题是怎么产生的，又该如何解决。希望能帮大家少走弯路，提升JSON处理效率。
JSON核心语法基础回顾
标准JSON的语法规范非常严格，绝大多数错误都源于对基本规则的忽视。这里列出几条硬性规定：
- 键名必须使用双引号包裹，单引号或无引号均不合法；
- 字符串值也只接受双引号，单引号会被直接判为非法；
- JSON中禁止添加任何注释，无论是
//还是/* */，一旦出现就会解析失败； - 数组和对象的末尾不能有多余逗号；
- 支持的数据类型只有六种：字符串、数字、布尔值、数组、对象、
null。像undefined、函数、日期对象等，通通不支持。
这些规则看似不多，但每一条都是实际开发中的高频陷阱。下面我们使用Python的json库进行演示，因为日常开发中Python的序列化与反序列化操作非常普遍。
高频踩坑案例与实战代码演示
案例1：键名使用单引号或省略引号
问题描述
新手经常把Python字典的写法直接套用到JSON上，键名用单引号，或者干脆不加引号。标准JSON解析器一旦遇到这种情况，就会直接抛出异常。例如：
{'name': "张三", age: 20}
错误复现代码
import json
# 错误格式的JSON字符串（单引号键名 + 无引号键名）
error_json_str = "{'name': '张三', age: 20}"
try:
data = json.loads(error_json_str)
except json.JSONDecodeError as e:
print(f"解析失败：{e}")
运行结果：程序直接抛出JSONDecodeError，解析终止。
正确写法
牢记：JSON键名必须统一使用双引号。
{"name": "张三", "age": 20}
# 正确格式的JSON字符串
right_json_str = '{"name": "张三", "age": 20}'
data = json.loads(right_json_str)
print(data)
案例2：对象或数组末尾出现多余逗号
问题描述
编写JSON时，在最后一个元素后面顺手加一个逗号，很多严格的解析器都会直接报错。这是前后端联调时极易碰到的问题。例如：
{
"id": 1,
"hobby": ["读书", "运动",]
}
错误复现代码
import json
error_str = '''{
"id": 1,
"hobby": ["读书", "运动",]
}'''
try:
res = json.loads(error_str)
except json.JSONDecodeError as e:
print(f"多余逗号报错：{e}")
正确写法
直接删除末尾多余逗号即可：
{
"id": 1,
"hobby": ["读书", "运动"]
}
案例3：在JSON中添加注释
问题描述
部分开发者习惯在JSON里加入注释，用来解释某个字段的作用。但标准JSON完全不允许任何注释存在，添加后就会解析失败。例如：
{
"username": "test", // 用户名
"password": "123456" /* 登录密码 */
}
错误复现代码与解决方案
import json
# 包含注释的JSON字符串
comment_json = '''{
"username": "test", // 用户名
"password": "123456"
}'''
try:
json.loads(comment_json)
except json.JSONDecodeError:
print("JSON禁止添加注释，解析失败")
最简单的解决方案：将所有注释删除。如果确实需要说明字段含义，可以单独维护一份文档，不要把注释写在JSON文件中。
案例4：特殊字符未转义
问题描述
字符串中如果包含双引号、换行符、反斜杠等特殊字符，没有进行转义处理，就会破坏JSON的整体结构。例如：
{
"content": "他说："今天天气很好""
}
代码演示与修复
import json
# 包含双引号、换行符的内容
content = '他说："今天天气很好"\n心情愉悦'
data = {"content": content}
# 序列化为标准JSON（自动完成转义）
json_str = json.dumps(data, ensure_ascii=False)
print("标准JSON：", json_str)
# 反序列化验证
parse_data = json.loads(json_str)
print("解析结果：", parse_data["content"])
手动编写JSON时，需要手动添加转义符\。不过使用json.dumps序列化时，它会自动处理字符转义，大大降低了出错概率。
案例5：数据类型不兼容
问题描述
JSON不支持undefined、函数、日期对象等非标准类型。如果直接序列化，要么抛出异常，要么数据丢失。
代码演示
import json
from datetime import datetime
# 包含日期对象（非JSON标准类型）
data = {"name": "李四", "create_time": datetime.now()}
try:
json.dumps(data)
except TypeError as e:
print(f"类型不兼容报错：{e}")
解决方案：先将日期、特殊对象转换为字符串或数字，确保所有值都属于JSON支持的标准类型，然后再进行序列化。
总结
回顾这些案例不难发现，JSON的坑大多源自对核心语法规范的忽视。日常开发中，只要牢记以下五个要点：键名使用双引号、禁止添加注释、杜绝末尾逗号、特殊字符必须转义、只使用标准数据类型，就能避开绝大多数问题。在对接第三方接口、读取配置文件、进行前后端数据交互时，优先使用官方内置的解析库，避免手动拼接JSON字符串，这样可以显著降低出错概率。一旦遇到解析报错，首先检查语法格式、特殊字符和数据类型，问题基本就能快速定位和解决。
