杜不知道1. 当Python遇上不规范的JSON字符串
最近在对接第三方API时，我遇到了一个让人头疼的问题：明明看起来是JSON格式的字符串，用json.loads()解析时却总是报错。错误信息显示"Expecting property name enclosed in double quotes"，意思是JSON属性名需要用双引号包裹。这让我意识到，很多开发者在使用Python处理JSON数据时都会遇到类似问题，特别是当数据来源不可控时。
JSON作为一种轻量级的数据交换格式，在Web开发、API交互、配置文件等场景中无处不在。Python内置的json模块虽然强大，但对JSON格式的规范性要求非常严格。根据RFC 8259规范，合法的JSON字符串必须使用双引号表示属性名和字符串值，而单引号或没有引号的属性名都会导致解析失败。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 问题诊断：为什么JSON属性名必须用双引号？
2.1 JSON规范与Python实现的差异
JSON的官方规范明确要求属性名必须使用双引号包裹。这种严格性源于JSON的设计初衷——作为一种可预测、无歧义的数据交换格式。Python的json模块严格遵循这一规范，因此当我们尝试解析{'status':404}这样的字符串时，就会遇到JSONDecodeError。
有趣的是，Python本身的字典语法允许使用单引号，这导致很多开发者会误以为JSON也支持这种写法。我曾经就犯过这样的错误，把一个Python字典直接str()转换后当作JSON字符串使用，结果当然是以失败告终。
2.2 常见不规范JSON的来源
在实际开发中，不规范JSON的来源主要有以下几种：
- 人工编辑的配置文件：很多开发者为了方便，会直接使用Python风格的字典写法来配置JSON文件
- 老旧系统生成的输出：一些历史遗留系统可能使用非标准的JSON序列化方式
- 字符串拼接生成的伪JSON：动态构建JSON字符串时容易忽略引号规范
- 其他语言序列化的输出：某些语言的JSON库可能对规范要求不严格
3. 解决方案：修复不规范JSON的多种方法
3.1 简单替换法：单引号变双引号
对于简单的JSON字符串，最直接的修复方法就是替换单引号为双引号：
python复制import json
bad_json = "{'status': 404}"
fixed_json = bad_json.replace("'", '"')
data = json.loads(fixed_json)
这种方法适用于大多数简单场景，但有几个注意事项：
- 如果字符串值本身包含单引号，可能会被错误替换
- 无法处理没有引号的属性名（如
{status:404}） - 对于嵌套的特殊字符处理不够智能
3.2 使用ast.literal_eval安全评估
Python的ast模块提供了literal_eval方法，可以安全地评估包含Python字面量的字符串：
python复制import ast
bad_json = "{'status': 404}"
data = ast.literal_eval(bad_json)
# 然后可以再将data转为合法JSON
valid_json = json.dumps(data)
这种方法的优点是：
- 能正确处理各种Python风格的字典写法
- 比直接使用
eval()安全得多 - 保留原始数据结构
缺点是：
- 性能比直接使用
json.loads()稍差 - 对某些极端情况可能仍然会报错
3.3 正则表达式高级修复
对于更复杂的情况，可以使用正则表达式进行智能替换：
python复制import re
import json
bad_json = "{status: 404, 'message': 'It\\'s broken'}"
# 匹配属性名并添加双引号
fixed_json = re.sub(r"(['\"]?)(\w+)\1\s*:", r'"\2":', bad_json)
data = json.loads(fixed_json)
这个正则表达式会：
- 匹配带引号或不带引号的属性名
- 统一替换为带双引号的属性名
- 保留字符串值中的引号不变
4. 预防胜于治疗：生成规范的JSON
4.1 始终使用json.dumps()生成JSON
最好的防御就是从一开始就生成规范的JSON。Python的json.dumps()方法会自动处理所有规范问题：
python复制import json
data = {'status': 404}
valid_json = json.dumps(data) # 输出: {"status": 404}
4.2 处理特殊数据类型
当字典中包含日期、Decimal等非JSON原生类型时，需要自定义编码器：
python复制from datetime import datetime
import json
class CustomEncoder(json.JSONEncoder):
def default(self, obj):
if isinstance(obj, datetime):
return obj.isoformat()
return super().default(obj)
data = {'time': datetime.now()}
valid_json = json.dumps(data, cls=CustomEncoder)
4.3 配置json.dumps()参数
json.dumps()提供了一些有用的参数来优化输出：
ensure_ascii=False：允许非ASCII字符indent=2：美化输出，便于阅读separators=(',', ':')：压缩输出体积
5. 高级场景与疑难杂症
5.1 处理嵌套的特殊结构
有时候我们会遇到包含元组、集合等非JSON标准结构的伪JSON字符串：
python复制bad_json = "{'scores': (['math', 90], ['physics', 85])}"
修复这类数据需要多步处理：
- 替换单引号为双引号
- 将元组
()转换为列表[] - 将Python的
None替换为JSON的null
python复制fixed_json = (bad_json.replace("'", '"')
.replace("(", "[")
.replace(")", "]")
.replace("None", "null"))
data = json.loads(fixed_json)
5.2 性能优化建议
当需要处理大量不规范JSON时，性能成为关键考虑因素。以下是一些优化建议：
- 对于确定格式的不规范JSON，编写专门的解析函数
- 使用
str.translate()代替多次str.replace()进行批量字符替换 - 考虑使用
ujson或orjson等第三方高性能JSON库
python复制# 使用str.translate进行高效字符替换
trans_table = str.maketrans({"'": '"', "(": "[", ")": "]"})
fixed_json = bad_json.translate(trans_table)
5.3 日志记录与错误处理
健壮的生产代码应该妥善处理各种不规范JSON情况：
python复制import logging
def safe_json_parse(json_str):
try:
return json.loads(json_str)
except json.JSONDecodeError as e:
logging.warning(f"Failed to parse JSON: {e}")
try:
fixed = json_str.replace("'", '"')
return json.loads(fixed)
except json.JSONDecodeError:
logging.error("Unable to repair JSON string")
return None
在实际项目中，我通常会创建一个专门的JSON工具模块，集中处理各种边缘情况和异常。这样既保证了代码复用，又能统一处理逻辑。记住，处理外部数据时永远不要相信输入是规范的，防御性编程是关键。